home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 1 / Cream of the Crop 1.iso / UTILITY / TOP110.ARJ / TOP.DAT / MANUAL.TXT < prev    next >
Text File  |  1992-05-14  |  171KB  |  4,981 lines
  1. ################################################################################
  2. ################################################################################
  3.  
  4.                   TTTTTTTTTTT   OOOOOOOOOOOO   PPPPPPPPPPPP
  5.                   TTTTTTTTTTT   OOOOOOOOOOOO   PPPPPPPPPPPP
  6.                       TTT       OOO      OOO   PPP      PPP
  7.                       TTT       OOO      OOO   PPP      PPP
  8.                       TTT       OOO      OOO   PPPPPPPPPPPP
  9.                       TTT       OOO      OOO   PPPPPPPPPPPP
  10.                       TTT       OOOOOOOOOOOO   PPP
  11.                       TTT       OOOOOOOOOOOO   PPP
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.                                      TOP
  31.                                  The Premier
  32.                        DOS Command Enhancement Utility
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47. ____________
  48.   |       __
  49.   | |\ | |                                           _______
  50.   | | \| |__                                    ____|__     |               (R)
  51.                                              --|       |    |-------------------
  52. TOP Copyright (c) 1990, 1991, 1992             |   ____|__  |  Association of
  53. by TNC Technology, All Rights Reserved         |  |       |_|  Shareware
  54. GTDR                                           |__|   o   |    Professionals
  55.                                              -----|   |   |---------------------
  56. Another fine product from TNC Technology          |___|___|    MEMBER
  57.  
  58. ################################################################################
  59. ################################################################################
  60.  
  61.  
  62. TNC Technology                                                        TOP Manual
  63.  
  64. TOP(tm) Command Enhancement Utility
  65.  
  66. Written by: Leon C. Williams (he never sleeps)
  67. Executive Producer: Tom Beikirch (he complains a lot)
  68.  
  69. TOP(tm) Program and documentation Copyright (c) 1990, 1991, 1992 by TNC
  70. Technology. All rights reserved, GTDR.
  71.  
  72. TOP(tm) is a trademark of TNC Technology.
  73.  
  74. PC(tm), PC-DOS(tm), PC XT(tm), PC AT(tm), PS/2(tm), and IBM(tm) are registered
  75. trademarks of IBM Corporation.
  76.  
  77. MS-DOS(tm) and OS/2(tm) are registered trademarks of Microsoft Corporation.
  78.  
  79. UNIX(tm) is a registered trademark of AT&T Corporation.
  80.  
  81. Kleenex(tm) is a registered trademark of Kimberly-Clark Corp.
  82.  
  83. Direct any inquires about this program or documentation to:
  84.  
  85. TNC Technology
  86. 1084 Webster Road
  87. Webster, New York  14580
  88.  
  89. Voice: 716-872-1377 (after 6pm M-F EST, otherwise machine attended)
  90. BBS: 716-872-4913 (8-N-1, 24 hours)
  91. CompuServe: 70403,2351
  92.  
  93. Any other resemblance to any other person or trademark, real or fictional, is
  94. purely coincidental and in no way should be construed as harmful, malicious,
  95. purposeful, or anything else that could get us into trouble. So there.
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.                                                                                1
  120.  
  121.  
  122. TNC Technology                                                        TOP Manual
  123.  
  124. Acknowledgements
  125.  
  126. Special thanks to IBM(tm) and Microsoft for their never ending lack of features
  127. which created this market opportunity.
  128.  
  129. TOP is written in Microsoft C 6.0 and assembly language.
  130.  
  131. Several features were inspired by UNIX(tm).
  132.  
  133. This manual was created and formatted with Xerox Ventura Publisher 3.0.
  134.  
  135. The word DOS in this manual refers to either MS-DOS(tm) or PC-DOS(tm), your
  136. choice.
  137.  
  138. Many thanks to our Beta testers (in random order): Ray Clark, Greg Tellex,
  139. Jessie Zeck, Paul Norder, Dick Maus, Bob Beikirch, Francis Tse, Fred Hayes,
  140. Tommy Richenderfer, Rocky Martin, Bob Lonis, Bob Herloski, Bob Clarke, Theresa
  141. Ciccone, Joe Taille, Ned Seachman, YingWei Lin, John Moore, Tom Davis, Bart
  142. Selby, and Perry Bowen.
  143.  
  144. Both authors wish to thank their wives for their continued support and patience
  145. even when they didn't and weren't, and we'll be there any day now, we promise.
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.                                                                                2
  180.  
  181.  
  182. TNC Technology                                                        TOP Manual
  183.  
  184. TOP(tm) Registration Form
  185.  
  186. TOP Version 1.10
  187.  
  188. Mail To:   TNC Technology
  189.            1084 Webster Road
  190.            Webster, New York  14580
  191.  
  192. By phone:  716-872-1377, (after 6pm M-F EST)
  193.  
  194.                                                         Each   Quantity   Price
  195.  
  196. Disk, manual, plus one upgrade                           $50   _______   _______
  197.  
  198. Disk only, no upgrade                                    $40   _______   _______
  199.  
  200. Subtotal                                                                 _______
  201.  
  202. NY Residents please add 7% Sales Tax                                     _______
  203.  
  204. Shipping (included in continental USA, others add $3)                    _______
  205.  
  206. Technical Support for one year from purchase date                       Included
  207.  
  208. Additional Technical Support / Upgrade Licenses                         Call TNC
  209.  
  210. Total enclosed                                                           _______
  211.  
  212. Payment by:           __Check             __Money Order
  213.  
  214. Diskette size:        __5.25" acceptable  __3.5" required
  215.  
  216. Name:      ________________________________________________________
  217. Company:   ________________________________________________________
  218. Address:   ________________________________________________________
  219.            ________________________________________________________
  220.            ________________________________________________________
  221. Day Phone: ________________________________________________________
  222.  
  223. I have read and agree to abide by the TOP license and warrantee agreement
  224. (obtained by typing HELP !LICENSE at the prompt after starting TOP).
  225. (signed)   ________________________________________________________
  226.  
  227. Where did you get TOP? Please indicate your shareware registration number.
  228.            ________________________________________________________
  229.  
  230. Any suggestions or comments?
  231.            ________________________________________________________
  232.            ________________________________________________________
  233.            ________________________________________________________
  234.  
  235.  
  236.  
  237.  
  238.  
  239.                                                                                3
  240.  
  241.  
  242. TNC Technology                                                        TOP Manual
  243.  
  244. WARRANTEE
  245.  
  246. *** ONE YEAR MONEY BACK GUARANTEE ***
  247.  
  248. As with any software, TOP may inadvertently contain errors in programming or
  249. documentation. If you find any such error, or are otherwise dissatisfied with a
  250. registered version of TOP, you may return the entire package at any time up to
  251. one year after purchase for a full refund of your registration fee. This refund
  252. of your registration fee is the maximum liability assumed by TNC Technology,
  253. which is not liable for any other costs incurred by you for programming or
  254. documentation errors.
  255.  
  256. *** WARRANTEE DISCLAIMER ***
  257.  
  258. TNC Technology DISCLAIMS ALL WARRANTIES RELATING TO THIS SOFTWARE, WHETHER
  259. EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY IMPLIED WARRANTIES OF
  260. MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE, AND ALL SUCH WARRANTIES
  261. ARE EXPRESSLY AND SPECIFICALLY DISCLAIMED. NEITHER TNC Technology, NOR ANYONE
  262. ELSE WHO HAS BEEN INVOLVED IN THE CREATION, PRODUCTION, OR DELIVERY OF THIS
  263. SOFTWARE SHALL BE LIABLE FOR ANY INDIRECT, CONSEQUENTIAL, OR INCIDENTAL DAMAGES
  264. ARISING OUT OF THE USE OR INABILITY TO USE SUCH SOFTWARE EVEN IF TNC Technology
  265. HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES OR CLAIMS. IN NO EVENT
  266. SHALL TNC Technology LIABILITY FOR ANY DAMAGES EVER EXCEED THE PRICE PAID FOR
  267. THE LICENSE TO USE THE SOFTWARE, REGARDLESS OF THE FORM OF THE CLAIM. THE
  268. PERSON USING THE SOFTWARE BEARS ALL RISK AS TO THE QUALITY AND PERFORMANCE OF
  269. THE SOFTWARE.
  270.  
  271. Some states do not allow the exclusion of the limit of liability for
  272. consequential or incidental damages, so the above limitation may not apply to
  273. you.
  274.  
  275. This agreement shall be governed by the laws of the State of New York and shall
  276. inure to the benefit of TNC Technology, and any successors, administrators,
  277. heirs and assigns. Any action or proceeding brought by either party against the
  278. other arising out of or related to this agreement shall be brought only in a
  279. STATE or FEDERAL COURT of competent jurisdiction located in Monroe County, New
  280. York. The parties hereby consent to in personam jurisdiction of said courts.
  281.  
  282.  
  283.  
  284.  
  285.  
  286.  
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.                                                                                4
  300.  
  301.  
  302. TNC Technology                                                        TOP Manual
  303.  
  304. TOP(tm) License Agreement
  305.  
  306. This is a no-nonsense license agreement in that the terms outlined below are
  307. intended to be fair and reasonable. We do not, for example, expect you to buy
  308. two copies for your home and laptop computer any more than you do. So please
  309. help us maintain the integrity of this product by reading and abiding by the
  310. simple terms below, and sign the accompanying TOP registration form. In turn,
  311. we will continue to provide you with a quality product at a reasonable cost.
  312.  
  313. TOP and all other programs, documentation, and data distributed or shipped with
  314. it are copyrighted and are protected under United States and international
  315. copyright law. The programs, documentation, and data are collectively referred
  316. to in this manual as TOP. You are granted a license to use your copy of TOP
  317. only under the conditions and terms specified in this license agreement.
  318.  
  319. TOP is distributed as shareware, which means you can try it before you buy it.
  320. It is not free or public domain. You may use TOP at no charge for a period of
  321. 30 days. If you wish to continue using TOP after that period, you must pay the
  322. registration fee in the accompanying TOP registration form. If you choose not
  323. to pay the registration fee, you must stop using TOP and delete it and all
  324. ancillary programs from your computer. However, you may keep shareware copies
  325. and pass them along to others who may use them at no charge for 30 days.
  326.  
  327. You may use your registered version of TOP on multiple computers, provided
  328. there is no possibility that more than one person will be using it at any one
  329. time. Treat this software as if it were a book: you may loan it to someone but
  330. then you don't have it. Multiple user, network, and corporate licenses are
  331. available from TNC Technology.
  332.  
  333. You may copy TOP for backup purposes, and you may give copies of the
  334. unregistered shareware version of TOP to others. If you copy the unregistered
  335. shareware version for others, you must include all the files distributed with
  336. it. You may not charge a fee for distribution without express permission from
  337. TNC Technology.
  338.  
  339. You may not give, sell, or otherwise transfer copies of the registered version
  340. of TOP to any other person or company for any reason without the written
  341. consent of TNC Technology. You may transfer ownership of your registered
  342. version of TOP provided that when you do so, you delete it and all accompanying
  343. programs from your computer. If you do transfer ownership, please notify TNC
  344. Technology of the new owner so update information can be forwarded. You may not
  345. give, sell, or otherwise transfer your registered TOP user ID number.
  346.  
  347. TOP greatly extends the power and flexibility of your computing. We have taken
  348. many pains to ensure the software does not get you into trouble but, like any
  349. software, improper use can possibly damage or delete your computer software or
  350. data. You assume full responsibility for the selection and proper use of TOP;
  351. TNC Technology is not responsible for any damage whatsoever resulting from
  352. errors in usage or your failure to read and understand the instructions in this
  353. manual. If you have any questions about the use of TOP, you may call the TNC
  354. hot line given in Appendix A of the TOP manual.
  355.  
  356. As with any software, TOP may inadvertently contain errors in programming or
  357. documentation. If you find any such error, or are otherwise dissatisfied with a
  358.  
  359.                                                                                5
  360.  
  361.  
  362. TNC Technology                                                        TOP Manual
  363.  
  364. registered version of TOP, you may return the entire package at any time up to
  365. one year after purchase for a full refund of your registration fee. This refund
  366. of your registration fee is the maximum liability assumed by TNC Technology,
  367. which is not liable for any other costs incurred by you for programming or
  368. documentation errors.
  369.  
  370. If you do not agree with the terms in this license agreement, then you do not
  371. have permission from the copyright holders to use TOP, and must remove TOP from
  372. your computer.
  373.  
  374. Thank you for reading the TOP license agreement. Now, enjoy!
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.  
  404.  
  405.  
  406.  
  407.  
  408.  
  409.  
  410.  
  411.  
  412.  
  413.  
  414.  
  415.  
  416.  
  417.  
  418.  
  419.                                                                                6
  420.  
  421.  
  422. TNC Technology                                                        TOP Manual
  423.  
  424. ASP Ombudsman Notice
  425.  
  426. This program is produced by a member of the Association of Shareware
  427. Professionals (ASP). ASP wants to make sure that the shareware principle works
  428. for you. If you are unable to resolve a shareware-related problem with an ASP
  429. member by contacting the member directly, ASP may be able to help.
  430.  
  431. The ASP Ombudsman can help you                 _______
  432. resolve a dispute or problem with         ____|__     |               (R)
  433. an ASP member, but does not provide    --|       |    |-------------------
  434. technical support for members'           |   ____|__  |  Association of
  435. products. Please write to the ASP        |  |       |_|  Shareware
  436. Ombudsman at 545 Grover Road,            |__|   o   |    Professionals
  437. Muskegon, MI 49442 or send a Compu-    -----|   |   |---------------------
  438. Serve message via CompuServe Mail           |___|___|    MEMBER
  439. to ASP Ombudsman 70007,3536.
  440.  
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  
  467.  
  468.  
  469.  
  470.  
  471.  
  472.  
  473.  
  474.  
  475.  
  476.  
  477.  
  478.  
  479.                                                                                7
  480.  
  481. ################################################################################
  482. ################################################################################
  483.  
  484.  
  485.  
  486.  
  487.  
  488.  
  489.  
  490.  
  491.  
  492.  
  493.  
  494.  
  495.  
  496.  
  497.  
  498.  
  499.  
  500.  
  501.  
  502.  
  503.  
  504.  
  505.  
  506.  
  507.  
  508.  
  509.  
  510.                                   Chapter 1
  511.                                  Introduction
  512.  
  513.  
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.  
  533.  
  534.  
  535.  
  536.  
  537.  
  538. ################################################################################
  539. ################################################################################
  540.  
  541.  
  542. TNC Technology                                                        TOP Manual
  543.  
  544. Introduction
  545.  
  546. Welcome, and thank you for using TOP, the premier DOS command enhancement
  547. utility.
  548.  
  549. TOP was created by individuals who believe in the command line interface but
  550. were frustrated by the mundane, repetitive nature of DOS, just like you are.
  551. TOP is a well-behaved program which does not replace COMMAND.COM, but
  552. simplifies and adds to its usage. Since COMMAND.COM is not replaced, TOP will
  553. not exclude you from future DOS updates, nor will it make obsolete your current
  554. DOS work that you've slaved to create. TOP will simply make your work more
  555. productive by speeding up and simplifying many repetitive tasks you do every
  556. day.
  557.  
  558. TOP is a DOS shell type program, but not in the sense that it tries to isolate
  559. the user from DOS. Rather, TOP simplifies and speeds up DOS commands in the
  560. background by pre-processing each command line. Special new commands have been
  561. added which fill the gaps DOS left behind. Judicious use of the new commands
  562. can greatly enhance performance as well as simplify any complex command.
  563.  
  564. What to Read?
  565.  
  566. For the most part, nobody ever reads the manual until they get into trouble. If
  567. you're one of these people, TOP will work for you anyway because it's EASY!
  568. After all, the best way to learn any new program is to just try it! For you,
  569. there is a chapter entitled "TOP Command Reference" which you can refer to when
  570. you have a particular question. However, many of the features TOP provides are
  571. subtle and not so obvious at first, but will become much appreciated as you get
  572. to know them. To get the most out of TOP, we recommend you at least browse
  573. chapter 4, "Using TOP," which presents an overview of how to use all of TOP's
  574. feature set, and chapter 1, "Customization and TOP.INI," which explains how to
  575. customize TOP's interface to you.
  576.  
  577. How TOP Works
  578.  
  579. TOP works by intercepting everything you type on the command line, before DOS
  580. gets a chance to muck with it. If the command you type is something TOP
  581. recognizes, it quickly executes it without DOS intervention. Otherwise, the
  582. command is passed to DOS. In this way TOP adds new commands and command
  583. enhancements without blocking you from future DOS updates.
  584.  
  585.  
  586.  
  587.  
  588. TOP is a "DOS Shell" type program, not a terminate and stay resident (TSR)
  589. program. The term "shell" is used because TOP runs on TOP of DOS and forms an
  590. extra layer of software between you and the operating system. Once started, TOP
  591. does not terminate (unless you exit). Because TOP is always running, it does
  592. not need to "hook" into critical system interrupt vectors the way many ill-
  593. behaved utility programs do. The shell nature of TOP is inherently non-invasive
  594. to your system and does not interfere or conflict with even the most difficult
  595. and incompatible commercial programs you may own.
  596.  
  597. The shell approach is what allows TOP to interpret commands before they reach
  598.  
  599. Introduction                                                                 1-2
  600.  
  601.  
  602. TNC Technology                                                        TOP Manual
  603.  
  604. DOS and handle ones it recognizes instantly and efficiently. Remember, commands
  605. TOP does not recognize are simply passed through to DOS. Commands TOP would not
  606. recognize include any commands in future DOS updates and therefore you will not
  607. be blocked from using them. Other commands TOP does not recognize are of course
  608. all your other user programs.
  609.  
  610. Whenever TOP passes an unrecognized command to DOS, it first removes itself
  611. from DOS memory ("swaps out") to minimize its use of DOS resources as much as
  612. possible. For all intents and purposes, during execution of any unrecognized
  613. DOS command or your programs, TOP is essentially "gone."
  614.  
  615. Is There Anything TOP Won't Do?
  616.  
  617. So what won't TOP do? Well, it doesn't cook breakfast (unless your PC is wired
  618. to the stove-use a CRON entry). More importantly, since TOP is not actually
  619. there when your programs are running, its features are unavailable then too.
  620. For example, don't expect a CRON job or a TOPDMT to be run while you're working
  621. with your word processor (any missed CRON jobs will be run right after TOP
  622. resumes execution). See the chapter "Using TOP" for more details on CRON and
  623. TOPDMT jobs.
  624.  
  625. Manual Typographic Conventions
  626.  
  627. This fancy title refers to the style of type used throughout this manual. All
  628. manual text appears as you see it here, except user examples. User examples are
  629. shown in a fixed space type, and look like:
  630.  
  631. C:\TOP>myprog parm1 [parm2]<ENTER>
  632.  
  633. User examples will always be indented as above. Underlined text in examples
  634. identifies the text the user is expected to type, and items contained in square
  635. brackets [ ] are optional.
  636.  
  637. In examples or manual text, a keyboard key other than a letter or number is
  638. referred to by its name and will be enclosed in angle brackets <> to indicate a
  639. single keypress. For example, <ALT> refers to the "Alt" key, or <ENTER> refers
  640. to the "Enter" key.
  641.  
  642. All examples assume your PROMPT line at least contains the string $p$g so the
  643. current directory followed by the > character is displayed as part of your
  644. prompt; this is not absolutely necessary, but will make your screen match the
  645. examples.
  646.  
  647. One Last Word on Shareware
  648.  
  649. TOP is distributed as shareware, which means you can try it before you buy it.
  650. Many midnight hours went into the reading of obscure DOS technical reference
  651. manuals before TOP was completed, so if you like the program, and believe that
  652. the little guy can someday rise above the tyranny of working for someone else
  653. all his life, a registration fee is requested to help pay for glasses, a new
  654. keyboard, and many related future products. If you send in your full
  655. registration fee, we will send you a version of TOP that does not print an
  656. annoying message to the screen after 30 days, as well as a nicely printed
  657. manual. Also, you will be kept informed of any future updates or bug fixes. In
  658.  
  659. Introduction                                                                 1-3
  660.  
  661.  
  662. TNC Technology                                                        TOP Manual
  663.  
  664. the meantime, please feel free to share the unregistered shareware version of
  665. TOP with your friends.
  666.  
  667.  
  668.  
  669.  
  670.  
  671.  
  672.  
  673.  
  674.  
  675.  
  676.  
  677.  
  678.  
  679.  
  680.  
  681.  
  682.  
  683.  
  684.  
  685.  
  686.  
  687.  
  688.  
  689.  
  690.  
  691.  
  692.  
  693.  
  694.  
  695.  
  696.  
  697.  
  698.  
  699.  
  700.  
  701.  
  702.  
  703.  
  704.  
  705.  
  706.  
  707.  
  708.  
  709.  
  710.  
  711.  
  712.  
  713.  
  714.  
  715.  
  716.  
  717.  
  718.  
  719. Introduction                                                                 1-4
  720.  
  721. ################################################################################
  722. ################################################################################
  723.  
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730.  
  731.  
  732.  
  733.  
  734.  
  735.  
  736.  
  737.  
  738.  
  739.  
  740.  
  741.  
  742.  
  743.  
  744.  
  745.  
  746.  
  747.  
  748.  
  749.  
  750.                                   Chapter 2
  751.                                    Features
  752.  
  753.  
  754.  
  755.  
  756.  
  757.  
  758.  
  759.  
  760.  
  761.  
  762.  
  763.  
  764.  
  765.  
  766.  
  767.  
  768.  
  769.  
  770.  
  771.  
  772.  
  773.  
  774.  
  775.  
  776.  
  777.  
  778. ################################################################################
  779. ################################################################################
  780.  
  781.  
  782. TNC Technology                                                        TOP Manual
  783.  
  784. TOP Features
  785.  
  786. TOP is NOT a replacement for COMMAND.COM as are some DOS command enhancement
  787. utilities. It therefore does not exclude users from future DOS updates, nor
  788. does it make your current DOS work obsolete. TOP works by preprocessing all
  789. command line arguments before they can be passed to COMMAND. If the command
  790. line contains arguments which TOP recognizes, such as special TOP commands,
  791. these are executed immediately. Otherwise, the arguments are simply passed to
  792. COMMAND and executed normally.
  793.  
  794. TOP recognizes several normal DOS commands and executes these faster and more
  795. efficiently. However, the real power of TOP can be found in the new commands
  796. and features which have been added to the DOS environment, including:
  797.  
  798. Minimal Memory Usage
  799.  
  800. TOP utilizes expanded, extended, or disk file memory to swap out a transient
  801. portion of its run file. The resident portion of TOP requires less than 3K
  802. bytes of RAM.
  803.  
  804. Context Sensitive Help
  805.  
  806. At the press of a key or click of the mouse, context sensitive HELP is
  807. available. What's more, you don't have to leave HELP to continue with what
  808. you're doing! HELP message text can be cut and pasted from the screen into your
  809. command line using the mouse. All HELP messages are read from an ascii text
  810. file which can be user modified or added to. You can even add HELP messages for
  811. your own programs. Call TNC Technology for information regarding specialized
  812. HELP files, including alternate (foreign) languages.
  813.  
  814. Extended VGA Text Mode Support
  815.  
  816. TOP supports all the extended VGA text modes of most popular video card
  817. manufacturers. No special ANSI drivers or special utilities required! See the
  818. README.VGA file on your release disk.
  819.  
  820. Command History
  821.  
  822. TOP can store and recall hundreds of previously issued commands. Any of these
  823. can be quickly retrieved, edited, and re-issued using enhanced search
  824. capabilities. The current command history can be saved and restored from disk
  825. allowing the command history to be continued from a previous TOP session.
  826.  
  827. Aliasing
  828.  
  829. TOP provides the ability to assign aliases. Aliases are user-defined command
  830. sequences which can be assigned to a single word. Aliases can be thought of as
  831. RAM resident batch files, and therefore execute two to three times faster than
  832. DOS batch files. Aliases can be nested and can accept command line arguments
  833. just like batch files.
  834.  
  835. Chronometer Functions (CRON)
  836.  
  837. One of the most powerful features of TOP, CRON gives you the ability to execute
  838.  
  839. Features                                                                     2-2
  840.  
  841.  
  842. TNC Technology                                                        TOP Manual
  843.  
  844. programs periodically on a user-defined schedule. Entries in the execution
  845. schedule can include wildcards, lists, and ranges of times and dates. Imagine a
  846. backup which happens automatically every hour or every Friday afternoon! How
  847. about Westminister chimes every fifteen minutes? Or set a reminder for the day
  848. before that anniversary you always forget. CRON functions can be set for any
  849. minute of the year, months in advance. And CRON does not forget to execute a
  850. scheduled job even if your computer was off! Interesting audio and video
  851. programs have been included with your shareware TOP release to demonstrate and
  852. enhance this feature (and more are included with the registered version).
  853.  
  854. Quick and Intuitive Mouse Support
  855.  
  856. TOP provides quick, pop-up access to help, its history buffer, user-defined
  857. aliases, its file finder, and its file viewer via any Microsoft compatible (two-
  858. button) mouse. Also, text can be copied from anywhere on the screen and then
  859. pasted into the command line. Keyboard usage can be cut dramatically!
  860.  
  861. Automatic Time-out Program
  862.  
  863. Automatically execute a program after a user-definable period of idle time. The
  864. program can be any executable but is typically used as a "screen saver" or DMT.
  865. Several colorful screen saver programs have been included with the shareware
  866. version of TOP (several more are included with the registered version).
  867.  
  868. Multiple Commands on a Single Line
  869.  
  870. Several commands can be placed on the command line or in aliases simultaneously
  871. by separating them with the ^ character (or any other user defined character).
  872.  
  873. Enhanced Command Line Editing
  874.  
  875. See the entire command line as you scroll left to edit it! Additional functions
  876. have been added to delete forward or backward, and cut and paste text from
  877. anywhere on the screen. User defined cursor shape for overstrike and insert
  878. mode.
  879.  
  880. Screen Color Palette and Cursor Management
  881.  
  882. TOP doesn't just set your screen colors, it maintains your screen color palette,
  883.  mode, screen lines, typematic rate, and cursor size settings once and for all,
  884. even when other programs reset video modes or otherwise muck with them.
  885.  
  886. Recursive Directory, Move, and Delete Commands
  887.  
  888. Like XCOPY, these commands can work across all directories and subdirectories.
  889. With them you can locate or find duplicate files, list directories only, move
  890. files or entire directories (including subdirectories), rename directories,
  891. delete all matching files on an entire drive, even delete entire non-empty
  892. directories containing subdirectories!
  893.  
  894. Examine File Contents
  895.  
  896. A built-in file view tool lets you quickly see what's in that file. Unlike TYPE,
  897.  you can scroll up and down. VIEW enables text or hex display. Like HELP, while
  898.  
  899. Features                                                                     2-3
  900.  
  901.  
  902. TNC Technology                                                        TOP Manual
  903.  
  904. VIEWing a file you can still type at the command line, or use the mouse to cut
  905. and paste text from the file to the command line!
  906.  
  907. On-line File Directory Tool
  908.  
  909. A pop-up file directory tool lets you quickly display a directory listing of
  910. files and file info of any directory. Unlike DIR, you can scroll up and down to
  911. review the listing, or change directories or drives to display other listings.
  912. Like HELP, while displaying the file listing you can still type at the command
  913. line, or use the mouse to cut and paste file names from the listing to the
  914. command line!
  915.  
  916. Case-Sensitive PROMPT and Additional Meta Strings
  917.  
  918. The PROMPT meta strings are case sensitive. New meta strings include time in 12
  919. hour format, AM or PM meridian display, and current free disk space. These can
  920. be included as part of your PROMPT string. An example PROMPT string has been
  921. included with your release.
  922.  
  923. Time Updated ANSI String Variable
  924.  
  925. In addition to the PROMPT variable, a new ANSI string environment variable,
  926. TOPTIME, is recognized which is processed every second. This is particularly
  927. useful for displaying the current time on your screen, updated every second. An
  928. example TOPTIME string has been included with your release.
  929.  
  930. User-defined Function Keys
  931.  
  932. Assign command sequences to function keys to make often used commands a single
  933. keystroke! Keystroke functions are similar to aliases in power and can contain
  934. any DOS or TOP command as well as accept command line parameters.
  935.  
  936. Multiple File Parameters
  937.  
  938. Many TOP commands accept multiple file parameters. For example:
  939.  
  940. del *.txt *.doc
  941.  
  942. will delete files matching *.txt and files matching *.doc.
  943.  
  944. Enhanced Wildcards
  945.  
  946. Most TOP commands accept enhanced wildcards. For example:
  947.  
  948. copy *r*.txt d:
  949.  
  950. will copy files with an 'r' anywhere in the name and ending with '.txt' to
  951. drive d.
  952.  
  953. NISTIME
  954.  
  955. TOP includes a utility which dials up the National Institute of Standards and
  956. Technology (NIST) Automated Computer Time Service (ACTS), retrieves the time,
  957. and sets your clock.
  958.  
  959. Features                                                                     2-4
  960.  
  961.  
  962. TNC Technology                                                        TOP Manual
  963.  
  964. Command Line Completion
  965.  
  966. Pressing the <TAB> key will cycle through a list of files in the current
  967. directory at the cursor position in the command line, or cycle through a list
  968. of matches if the filename is partly typed or typed with a wildcard spec.
  969.  
  970. TOPSET
  971.  
  972. To make life easy for the novice and expert alike, TOP includes a complete
  973. setup tool called TOPSET. Complete with hundreds of lines of context sensitive
  974. help, TOPSET speeds your way through the customization of TOP's features.
  975.  
  976.  
  977.  
  978.  
  979.  
  980.  
  981.  
  982.  
  983.  
  984.  
  985.  
  986.  
  987.  
  988.  
  989.  
  990.  
  991.  
  992.  
  993.  
  994.  
  995.  
  996.  
  997.  
  998.  
  999.  
  1000.  
  1001.  
  1002.  
  1003.  
  1004.  
  1005.  
  1006.  
  1007.  
  1008.  
  1009.  
  1010.  
  1011.  
  1012.  
  1013.  
  1014.  
  1015.  
  1016.  
  1017.  
  1018.  
  1019. Features                                                                     2-5
  1020.  
  1021. ################################################################################
  1022. ################################################################################
  1023.  
  1024.  
  1025.  
  1026.  
  1027.  
  1028.  
  1029.  
  1030.  
  1031.  
  1032.  
  1033.  
  1034.  
  1035.  
  1036.  
  1037.  
  1038.  
  1039.  
  1040.  
  1041.  
  1042.  
  1043.  
  1044.  
  1045.  
  1046.  
  1047.  
  1048.  
  1049.  
  1050.                                   Chapter 3
  1051.                                  Installation
  1052.  
  1053.  
  1054.  
  1055.  
  1056.  
  1057.  
  1058.  
  1059.  
  1060.  
  1061.  
  1062.  
  1063.  
  1064.  
  1065.  
  1066.  
  1067.  
  1068.  
  1069.  
  1070.  
  1071.  
  1072.  
  1073.  
  1074.  
  1075.  
  1076.  
  1077.  
  1078. ################################################################################
  1079. ################################################################################
  1080.  
  1081.  
  1082. TNC Technology                                                        TOP Manual
  1083.  
  1084. Installation Procedure
  1085.  
  1086. You will find the installation of TOP is simple and quick. TOP comes with and
  1087. uses an ascii editable initialization file called TOP.INI that is completely
  1088. filled out with harmless default choices and lots of comments. No other files
  1089. or setups are required. After installing TOP, the initialization file can be
  1090. easily modified by using TOP's setup utility, TOPSET.
  1091.  
  1092. Hardware Requirements
  1093.  
  1094. TOP is written for the IBM PC, PC/XT, PC/AT and 100% compatibles. It requires
  1095. DOS version 3.0 or above. A hard disk is recommended with about 690 Kbytes of
  1096. space for TOP files, and about 120 Kbytes for TOP audio and video accessories.
  1097. A Microsoft or compatible mouse is recommended to take advantage of the pop-up
  1098. mouse interface but is not required. TOP will take advantage of extended or
  1099. expanded memory if present, or can use standard memory or disk file space if
  1100. not.
  1101.  
  1102. The Installation Procedure
  1103.  
  1104. The distribution disk contains three files. The first file is called
  1105. INSTALL.BAT and is a batch file used to automatically extract the compressed
  1106. TOP files on your release disk. The second file contains all TOP files in
  1107. compressed format and is called TOP.DAT. This file will be extracted to all the
  1108. files and subdirectories necessary to run TOP when INSTALL is executed. The
  1109. third file is called READ.ME and contains condensed installation instructions.
  1110.  
  1111. Before you begin with the installation, jot down the registration number on
  1112. your release disk so you will have it handy when INSTALL asks for it. If this
  1113. is a shareware release, you will not need a number.
  1114.  
  1115. Installation of TOP is simple and straight forward. When INSTALL is run, sample
  1116. initialization files and setup parameters will be created to help you get up
  1117. and running immediately. Simply insert the TOP release disk into your floppy
  1118. drive, log on to that drive, and type INSTALL at the DOS prompt. The default
  1119. drive and directory INSTALL places TOP in is C:\TOP. For example, if your
  1120. floppy drive is drive A: and you want to install TOP to drive C:, you would do
  1121. the following (user input is underlined):
  1122.  
  1123. C:\> A:<ENTER>
  1124.  
  1125. A:\> INSTALL<ENTER>
  1126.  
  1127. -Extraction Messages-
  1128.  
  1129. -Enter registration number-
  1130.  
  1131. C:\TOP>
  1132.  
  1133. After you have completed the installation (and run TOP at least once), all
  1134. TOP files will have been created.
  1135.  
  1136. Installing To Another Directory
  1137.  
  1138.  
  1139. Installation                                                                 3-2
  1140.  
  1141.  
  1142. TNC Technology                                                        TOP Manual
  1143.  
  1144. You may also include a destination drive letter and a destination path if you
  1145. want to install TOP to another location. For example, if you wanted to install
  1146. TOP on drive D: you would type:
  1147.  
  1148. A:\> INSTALL D:<ENTER>
  1149.  
  1150. instead of the corresponding line above. If you wanted TOP to be installed in a
  1151. directory called MYDIR on drive E:, type:
  1152.  
  1153. A:\> INSTALL E: MYDIR<ENTER>
  1154.  
  1155. The colon must be used after the drive letter, and no leading or trailing back
  1156. slashes are allowed in the destination path name. Also, you must include a
  1157. space between the drive letter and the destination path name as shown above.
  1158.  
  1159. Post Installation
  1160.  
  1161. One last thing before we're done with installation: there must be a FILES=
  1162. statement in your CONFIG.SYS file. If you do not have a FILES= statement in
  1163. your CONFIG.SYS file, or do not have a CONFIG.SYS file, you must create one and
  1164. set the FILES equal to or greater than 9 (the default if not specified is 8).
  1165.  
  1166. The CONFIG.SYS file is a file in the root directory of your hard drive which is
  1167. used by DOS to load device drivers and extensions to DOS during boot time,
  1168. before the AUTOEXEC.BAT file is run. To create a CONFIG.SYS file from scratch
  1169. (if you don't have one) type:
  1170.  
  1171. cd\<ENTER>
  1172. copy con config.sys<ENTER>
  1173. files=20<CTRL+Z><ENTER>
  1174.  
  1175. Otherwise, simply edit the one you have. Remember to reboot after any
  1176. AUTOEXEC.BAT or CONFIG.SYS changes so the changes will take effect.
  1177.  
  1178. Starting TOP
  1179.  
  1180. TOP can now be started from the TOP directory by simply typing TOP at the
  1181. command prompt. TOP can also be started from another directory by typing the
  1182. entire path specification at the command prompt. For example, if you were in a
  1183. directory called MYDIR on drive D: and the TOP files were in a directory called
  1184. \TOP on drive C: you would type:
  1185.  
  1186. D:\MYDIR> c:\top\top<ENTER>
  1187.  
  1188. -TOP Startup Messages-
  1189.  
  1190. It is not required that the TOP directory be contained in your path statement,
  1191. however TOP.EXE must be located in the same directory as the ancillary TOP
  1192. files TOP.INI and TOP.HLP. TOP will determine the path to itself (and therefore
  1193. to its ancillary files) on start-up.
  1194.  
  1195. Most likely you will add a line to the end of your AUTOEXEC.BAT file to start
  1196. TOP when booting. The AUTOEXEC.BAT is a batch file run by DOS every time the
  1197. computer is booted. If the last line in your AUTOEXEC.BAT file is similar to
  1198.  
  1199. Installation                                                                 3-3
  1200.  
  1201.  
  1202. TNC Technology                                                        TOP Manual
  1203.  
  1204. c:\top\top
  1205.  
  1206. then TOP will be loaded and run after each boot up.
  1207.  
  1208. This completes the installation of TOP. Keep reading to find out more about EGA
  1209. 43 line mode, VGA 50 line mode, or extended VGA mode operation. Refer to
  1210. chapter 4, "Using TOP," to find out more about using the many features TOP can
  1211. provide, chapter 6, "Customization and TOP.INI" to learn more about TOP
  1212. customization, and Appendix E to learn more about TOP's setup utility, TOPSET.
  1213.  
  1214. Using EGA 43 Line, VGA 50 Line, or Extended VGA Modes
  1215.  
  1216. DOS 4.0+ provides minimal support for EGA 43 line mode and VGA 50 line mode.
  1217. Previous DOS versions provide no support at all. If you are already using one
  1218. of these modes with DOS, you know the headaches: ANSI.SYS must be loaded, and
  1219. the mode constantly needs resetting every time another program resets it. TOP
  1220. has overcome these difficulties by providing complete support for EGA 43 line
  1221. and VGA 50 line mode, as well as support for most popular VGA card
  1222. manufacturer's extended text modes.
  1223.  
  1224. Using these modes is quite simple. Using TOP's setup utility, TOPSU, change the
  1225. VideoMode entry in the [Video] section (see chapter 6, "Customization and
  1226. TOP.INI" for more details). The mode you select will be maintained permanently
  1227. while TOP is in control.
  1228.  
  1229. If you have already been using some form of EGA 43 line or VGA 50 line mode,
  1230. using DOS 4.0+ and the MODE command, you must know that DOS requires ANSI.SYS
  1231. to be loaded to support these modes. TOP does not require ANSI.SYS to run in
  1232. these modes and if there is no other reason for ANSI.SYS you can optionally
  1233. remove it from your CONFIG.SYS file. Since TOP does not require ANSI.SYS for
  1234. anything else, including complex ANSI prompt strings, you might as well remove
  1235. it and consequently save some additional memory.
  1236.  
  1237. For extended VGA modes, see the file README.VGA that came with your release for
  1238. up to date information on mode numbers and capabilities. For extended VGA modes,
  1239.  DOS's ANSI.SYS must be removed as it does not support any extended VGA modes.
  1240. Again, TOP fully supports these modes and it is unlikely you will need ANSI. If
  1241. you absolutely have to have ANSI.SYS loaded, you cannot use the extended VGA
  1242. modes, but you can still take advantage of EGA 43 or VGA 50 line modes.
  1243.  
  1244.  
  1245.  
  1246.  
  1247.  
  1248.  
  1249.  
  1250.  
  1251.  
  1252.  
  1253.  
  1254.  
  1255.  
  1256.  
  1257.  
  1258.  
  1259. Installation                                                                 3-4
  1260.  
  1261. ################################################################################
  1262. ################################################################################
  1263.  
  1264.  
  1265.  
  1266.  
  1267.  
  1268.  
  1269.  
  1270.  
  1271.  
  1272.  
  1273.  
  1274.  
  1275.  
  1276.  
  1277.  
  1278.  
  1279.  
  1280.  
  1281.  
  1282.  
  1283.  
  1284.  
  1285.  
  1286.  
  1287.  
  1288.  
  1289.  
  1290.                                   Chapter 4
  1291.                                   Using TOP
  1292.  
  1293.  
  1294.  
  1295.  
  1296.  
  1297.  
  1298.  
  1299.  
  1300.  
  1301.  
  1302.  
  1303.  
  1304.  
  1305.  
  1306.  
  1307.  
  1308.  
  1309.  
  1310.  
  1311.  
  1312.  
  1313.  
  1314.  
  1315.  
  1316.  
  1317.  
  1318. ################################################################################
  1319. ################################################################################
  1320.  
  1321.  
  1322. TNC Technology                                                        TOP Manual
  1323.  
  1324. Using TOP
  1325.  
  1326. Using TOP is as easy as using DOS. Up until now you've only heard what the
  1327. features are, not how to use them. This chapter describes how to work the
  1328. powerful and yet simple features that TOP provides.
  1329.  
  1330. This chapter presents an overview of all TOP features. If, after reading this
  1331. chapter, you still need more details about a particular feature, refer to the
  1332. TOP Command Reference chapter to follow. Also, see the chapter, "Customization
  1333. and TOP.INI," which describes how you can customize TOP by modifying the TOP
  1334. initialization file TOP.INI. In fact, many features described below are
  1335. controlled through the use of TOP.INI.
  1336.  
  1337. Starting TOP
  1338.  
  1339. Whenever TOP is started, it first searches the current directory, then the
  1340. directory it was loaded from for a file called TOP.INI. This file contains many
  1341. parameters which are used to initialize TOP to your specification. TOP.INI is
  1342. also a good place to put any initial TOP commands that you may wish to execute
  1343. that could not otherwise be executed under DOS. See the [InitialCommands]
  1344. section of the chapter, "Customization and TOP.INI" for more details.
  1345.  
  1346. If you started TOP with the default TOP.INI file, some changes to your old DOS
  1347. display will be immediately apparent. For one thing, the prompt characters are
  1348. not capitalized, and there appears to be a live clock display in the upper
  1349. right corner. These are just some of the new features you now have control
  1350. over. You can also use TOP to:
  1351.  
  1352. Get on-line context sensitive help by pressing <F1> (go on-try it).
  1353.  
  1354. Recall or search for previously issued commands using HISTORY.
  1355.  
  1356. Use enhanced editing features to edit the command line.
  1357.  
  1358. Put multiple commands on the command line.
  1359.  
  1360. Assign user defined command sequences to a single word using ALIAS.
  1361.  
  1362. Schedule programs to be executed once or periodically at some future time using
  1363. CRON.
  1364.  
  1365. Define case sensitive prompts with TOPPROMPT.
  1366.  
  1367. Automatically write an ANSI string every second using TOPTIME.
  1368.  
  1369. Automatically execute a user-specified program if the computer remains idle
  1370. using TOPDMT.
  1371.  
  1372. Define keystroke macros to unused function keys using FKEY.
  1373.  
  1374. Specify and maintain a user-defined color palette and video mode, regardless of
  1375. intervention by other programs.
  1376.  
  1377. Access many TOP features with your mouse.
  1378.  
  1379. Using TOP                                                                    4-2
  1380.  
  1381.  
  1382. TNC Technology                                                        TOP Manual
  1383.  
  1384. Move or rename files or directories using MOVE.
  1385.  
  1386. Delete non-empty directories or all matching files using XDEL.
  1387.  
  1388. Find files or directories and determine disk space usage using XDIR.
  1389.  
  1390. Quickly examine the contents of files using VIEW.
  1391.  
  1392. Change drive and directory simultaneously using CDD.
  1393.  
  1394. Save and recall the current directory using PUSHD and POPD.
  1395.  
  1396. Use Super VGA text modes!
  1397.  
  1398. Use multiple file parameters with most TOP commands.
  1399.  
  1400. Use enhanced wildcards.
  1401.  
  1402. Using your modem, dial up the National Institute of Technology and Standards
  1403. (NIST), retrieve the time, and accurately set your PC clock.
  1404.  
  1405. Automatically complete partially typed filenames at the command line.
  1406.  
  1407. On-Line HELP
  1408.  
  1409. On-line context sensitive help is available at any time during a command entry.
  1410. Unlike other "help" facilities which make you deactivate help before you can go
  1411. on, you may continue to type even when help is activated. In addition, the help
  1412. messages are read from an ascii text file which you can edit. Messages can be
  1413. customized, and new help messages can be added for your own programs!
  1414.  
  1415. Help is activated at any time by pressing <F1>, or by typing HELP optionally
  1416. followed by a keyword on the command line, or by using the mouse chord pop-up
  1417. (see the chapter "Using the Mouse and TOP Windows"). Command line invoked help
  1418. can be redirected to a printer or a file.
  1419.  
  1420. When help is activated with <F1> or the mouse, the first help message which
  1421. matches what you have typed so far on the command line is retrieved and
  1422. displayed in a window at the top of your screen. If more than one message is
  1423. available which matches what you have typed, pressing <F1> again will retrieve
  1424. the next matching message. This situation would occur particularly if what you
  1425. have typed is incomplete; for example typing only the letter D would cause HELP
  1426. to retrieve messages for DATE, DEL, DIR, DISKCOMP, and DISKCOPY. Pressing <ALT-
  1427. F1> deactivates help.
  1428.  
  1429. HELP Key Summary
  1430.  
  1431. The table below summarizes the HELP keys. These keys can be recalled at any
  1432. time by typing HELP _KEYS on the command line, or just type _KEYS and press
  1433. <F1>. Also see the chapter "Using the Mouse and TOP Windows".
  1434.  
  1435. HELP Key    | Description
  1436. --------------------------------------------------
  1437. F1          | Get HELP
  1438.  
  1439. Using TOP                                                                    4-3
  1440.  
  1441.  
  1442. TNC Technology                                                        TOP Manual
  1443.  
  1444. --------------------------------------------------
  1445. ALT-F1      | Clear HELP
  1446. --------------------------------------------------
  1447. ESC         | Clear current command line
  1448.  
  1449. Customizing the HELP File TOP.HLP
  1450.  
  1451. The help utility reads all its messages from a file called TOP.HLP, which must
  1452. be located in the same directory that TOP was loaded from, or in other words,
  1453. the same directory that TOP.EXE and TOP.INI is located in. The help file is
  1454. ascii editable in the following format:
  1455.  
  1456. [keyword] VersionNumber
  1457. Help message text. The message text contained here must contain lines of less
  1458. than 75 characters each (greater amounts are truncated). Each line ends with a
  1459. carriage return line feed.
  1460.  
  1461. Blank lines are OK. The message ends when a left square bracket is detected as
  1462. the first character in a line, i.e. the start of the next message.
  1463.  
  1464. Don't use more than 20 lines (more if you use EGA 43 or VGA 50 line mode) if
  1465. you want the help message to fit all on one page.
  1466.  
  1467. See the beginning of the included TOP.HLP file for more details.
  1468.  
  1469. The [keyword] is replaced by the keyword you want the help utility to recognize,
  1470.  and must be enclosed in square [ ] brackets. The version number is a number
  1471. like 3.2 and indicates the applicable DOS version. When TOP first reads the
  1472. help file on start-up, only the highest version entries which are less than or
  1473. equal to your current DOS version are retained. If no version is specified, the
  1474. message will be used with all DOS versions. The entries do not have to be in
  1475. any special order, although alphabetical by keyword and version is recommended
  1476. for ease of maintenance. All DOS and TOP commands have help messages in the
  1477. TOP.HLP file included in your release. Call TNC Technology for information
  1478. regarding specialized help files, including foreign language support.
  1479.  
  1480. The HISTORY Command Buffer
  1481.  
  1482. TOP saves previously issued commands into a command history buffer every time a
  1483. new command is issued. The contents of the buffer can be recalled, edited, and
  1484. re-issued.
  1485.  
  1486. The history buffer size is specified by the HistorySize entry in the
  1487. [Initialize] section of TOP.INI. See the chapter, "Customization and TOP.INI"
  1488. for more details. The maximum size of the history buffer is 32 Kbytes, or at
  1489. least 256 full length command lines. Since the commands are packed end to end
  1490. in the history buffer, many more than 256 commands can be stored if they are
  1491. not all the maximum length of 127 characters each. If the history buffer is
  1492. filled up, the oldest command is discarded before the new command is saved.
  1493.  
  1494. The entire contents of the history buffer can be viewed, saved, initialized,
  1495. and automatically saved to a file at the end of a session. In addition, the
  1496. contents of the history buffer can be saved after every execution of a user
  1497. specified number of commands by setting the HistoryAutoSaveCount entry in the
  1498.  
  1499. Using TOP                                                                    4-4
  1500.  
  1501.  
  1502. TNC Technology                                                        TOP Manual
  1503.  
  1504. [Initialize] section of TOP.INI. See the chapter, "Customization and TOP.INI"
  1505. for more details.
  1506.  
  1507. Simple Recall
  1508.  
  1509. There are two ways to recall a previously issued command. To scroll up to older
  1510. commands simply press the up arrow key. Repeated up arrow key presses scrolls
  1511. older and older commands. The down arrow key reverses the scroll to newer
  1512. commands. When you find the command you want, you can press enter to execute it
  1513. exactly or edit it prior to execution. In addition, pressing the <F9> or <F10>
  1514. keys recalls the oldest or newest command, respectively.
  1515.  
  1516. For example, suppose you have just compiled a program you were working on with
  1517. the following command:
  1518.  
  1519. c:\>compile myprog.c /A /C /NO /F=3
  1520.  
  1521. You find out you have a compile error and you use your editor to fix it. When
  1522. your finished, you push the up arrow key twice to recall the compile command
  1523. and re-execute it without having to retype it.
  1524.  
  1525. Search Recall
  1526.  
  1527. Previous commands can also be searched for by typing a few letters of the
  1528. command and hitting the <PAGE UP> key. The newest command containing the letter
  1529. sequence will be instantly recalled. Repeated presses of the page up key will
  1530. recall older and older commands containing the same letter sequence. A beep
  1531. indicates no more matches remain. Page down will recall newer commands
  1532. containing the same letter sequence. In the above example, the compile command
  1533. could be recalled by typing
  1534.  
  1535. c:\>comp<PAGE UP>
  1536.  
  1537. or even
  1538.  
  1539. c:\>og.c<PAGE UP>
  1540.  
  1541. followed by the page up key. The search text is remembered even after a command
  1542. is executed so a search can be continued or repeated. Just hit the page up key
  1543. without typing any text and the previous search text will be used.
  1544.  
  1545. When the command containing the search text is found, the search text is
  1546. displayed with a user-defined attribute. The default attribute is reverse text,
  1547. and can be changed by modifying the TOP.INI file's [Initialize] section. See
  1548. the chapter, "Customization and TOP.INI," for more details.
  1549.  
  1550. Pre-loading the History Buffer
  1551.  
  1552. To pre-load the history buffer on startup, specify the file containing the
  1553. desired history in the TOP.INI file's [Initialize] section. See the chapter,
  1554. "Customization and TOP.INI," for more details. The file containing the initial
  1555. history can be the history output file generated in the example above, or one
  1556. of your own. To create a history file, use your favorite text editor to
  1557. generate an ascii file containing a list of commands. Each command can be up to
  1558.  
  1559. Using TOP                                                                    4-5
  1560.  
  1561.  
  1562. TNC Technology                                                        TOP Manual
  1563.  
  1564. 128 characters, and ends with a carriage return.
  1565.  
  1566. Examine or Save the History Buffer
  1567.  
  1568. To examine the contents of the history buffer, just type history at the command
  1569. prompt. To save the current history buffer, redirect the output to a file, for
  1570. example:
  1571.  
  1572. c:\>history > history.txt
  1573.  
  1574. The above example saves the current history buffer contents to a file named
  1575. history.txt.
  1576.  
  1577. Saving a Command Without Execution
  1578.  
  1579. A command can be added to the history buffer without execution by pressing
  1580. <F5>.
  1581.  
  1582. Saving the History Buffer On Exit
  1583.  
  1584. The history buffer can be saved automatically whenever TOP is exited to the
  1585. same file it was pre-loaded from by modifying the HistorySave entry in the
  1586. TOP.INI file's [Initialize] section. See the chapter, "Customization and
  1587. TOP.INI," for more details.
  1588.  
  1589. Saving the History Buffer On Command Count
  1590.  
  1591. The history buffer can be saved automatically to the same file it was pre-
  1592. loaded from whenever TOP executes a user specified number of commands by
  1593. modifying the HistoryAutoSaveCount entry in the TOP.INI file's [Initialize]
  1594. section. See the chapter, "Customization and TOP.INI," for more details.
  1595.  
  1596. HISTORY Key Summary
  1597.  
  1598. The table below summarizes the HISTORY keys. These keys can be recalled at any
  1599. time by typing HELP _KEYS on the command line, or just type _KEYS and press
  1600. <F1>.
  1601.  
  1602. HISTORY Key | Description
  1603. --------------------------------------------------
  1604. Up Arrow    | Recall next older command from the
  1605.             | history buffer
  1606. --------------------------------------------------
  1607. Down Arrow  | Recall next newer command from the
  1608.             | history buffer
  1609. --------------------------------------------------
  1610. Page Up     | Search for next matching older
  1611.             | history command
  1612. --------------------------------------------------
  1613. Page Down   | Search for next matching newer
  1614.             | history command
  1615. --------------------------------------------------
  1616. F9          | Recall oldest saved command from
  1617.             | the history buffer
  1618.  
  1619. Using TOP                                                                    4-6
  1620.  
  1621.  
  1622. TNC Technology                                                        TOP Manual
  1623.  
  1624. --------------------------------------------------
  1625. F10         | Recall newest saved command from
  1626.             | the history buffer
  1627. --------------------------------------------------
  1628. F5          | Save the current command line to
  1629.             | the history buffer but do not
  1630.             | execute it
  1631.  
  1632. Enhanced Command Line Editing
  1633.  
  1634. So you just recalled a long command from the history buffer, and now you wish
  1635. you could change something? Try hitting the left arrow key. The cursor moves
  1636. into the command line without removing characters! Finally you can see what
  1637. you're editing.
  1638.  
  1639. The enhanced command line edit features are available at any time, whether you
  1640. have recalled a command from the history buffer, or you are in the process of
  1641. entering a command. For example, lets say you wanted to set the mode of your
  1642. com port, and you typed the following at the command line:
  1643.  
  1644. c:\>mode com1 9600,M,8,2,P
  1645.  
  1646. Before hitting <ENTER>, you press <F1> for help and find out the "M" is not a
  1647. valid setting for parity. To fix the command line, just hit the left arrow key
  1648. until the cursor is placed over the "M" and type "N". Now hit the <ENTER> key
  1649. and the correct command is issued.
  1650.  
  1651. Notice that even if you had issued the incorrect command, after getting bawled
  1652. out by DOS you can recall the incorrect command using the up arrow key and
  1653. still edit it the same way. Try it-it's easy!
  1654.  
  1655. When editing a command line, notice the cursor takes on the shape and color you
  1656. have defined in the [Video] section of TOP.INI. The cursor also changes shape
  1657. to indicate which mode you are editing in, either overwrite or insert mode. The
  1658. edit mode is toggled by hitting the <INSERT> key.
  1659.  
  1660. Enhanced Editing Key Summary
  1661.  
  1662. The table below lists the new enhanced edit key functions available with TOP.
  1663. These keys can be recalled at any time by typing HELP _KEYS on the command line,
  1664.  or just type _KEYS and press <F1>.
  1665.  
  1666. TOP Key     | Description
  1667. --------------------------------------------------
  1668. Left Arrow  | Move cursor left into command line
  1669. --------------------------------------------------
  1670. Right Arrow | Move cursor right within command
  1671.             | line, and/or recall characters from
  1672.             | the history buffer if available
  1673. --------------------------------------------------
  1674. Insert      | Toggle between overwrite and insert
  1675.             | edit modes
  1676. --------------------------------------------------
  1677. Backspace   | Delete the character to the left of
  1678.  
  1679. Using TOP                                                                    4-7
  1680.  
  1681.  
  1682. TNC Technology                                                        TOP Manual
  1683.  
  1684.             | the cursor
  1685. --------------------------------------------------
  1686. Delete      | Delete the character at the cursor
  1687.             | position
  1688. --------------------------------------------------
  1689. F2          | Copy history buffer characters to
  1690.             | up to and including the next
  1691.             | character you type after hitting F2
  1692. --------------------------------------------------
  1693. F3          | Copy history buffer characters to
  1694.             | end of line
  1695. --------------------------------------------------
  1696. F4          | Skip history buffer characters to
  1697.             | up to and including the next
  1698.             | character you type after hitting F4
  1699. --------------------------------------------------
  1700. F6          | Enter a Control-Z character at the
  1701.             | cursor
  1702. --------------------------------------------------
  1703. F7          | Move cursor left to the next
  1704.             | character you type after hitting F7
  1705. --------------------------------------------------
  1706. F8          | Move cursor right to the next
  1707.             | character you type after hitting F8
  1708. --------------------------------------------------
  1709. HOME        | Move cursor to start of line
  1710. --------------------------------------------------
  1711. END         | Move cursor to end of line
  1712. --------------------------------------------------
  1713. TAB         | Insert a filename from the current
  1714.             | directory at the cursor. See
  1715.             | "Command Line Completion" later in
  1716.             | this chapter
  1717.  
  1718. Multiple Commands on the Command Line
  1719.  
  1720. Multiple commands can be placed on a single command line. To do so, commands
  1721. must be separated by the command separator character specified in the TOP.INI
  1722. file. The default command separator character is the caret (^). For example,
  1723. the following command copies files from drive A to the root directory on drive
  1724. C and then displays a directory of the root on drive C:
  1725.  
  1726. c:\>copy a:*.txt c:\ ^ dir c:\*.txt
  1727.  
  1728. A space is not required before and after the caret as in the above example, but
  1729. may be added for clarity.
  1730.  
  1731. Aliases
  1732.  
  1733. One of the most powerful features of TOP, aliases are user-defined command
  1734. sequences which can are assigned to a single word. Aliases are assigned using
  1735. the ALIAS command, and are removed using the UNALIAS command. In addition,
  1736. initial aliases can be defined in the TOP.INI file in the [Alias] section.
  1737.  
  1738.  
  1739. Using TOP                                                                    4-8
  1740.  
  1741.  
  1742. TNC Technology                                                        TOP Manual
  1743.  
  1744. The alias name and argument length is only limited by the size of the internal
  1745. alias buffer, which is 64K bytes. All aliases names and their arguments must
  1746. fit in this buffer.
  1747.  
  1748. An alias may contain any command or combination of commands (using the command
  1749. separator character). However, each individual command between the command
  1750. separator is limited by the DOS command line length of 127 characters.
  1751.  
  1752. Because of the DOS command line length limit of 127 characters, an alias whose
  1753. total length is greater than 127 characters can only be specified in a file
  1754. (see below) or in the [Alias] section of the TOP.INI.
  1755.  
  1756. Aliases can be nested to any depth.
  1757.  
  1758. Simple Aliases
  1759.  
  1760. The simplest type of alias just assigns a new name to an existing command. For
  1761. example, typing:
  1762.  
  1763. defines an alias called list, which causes a directory to be displayed in date
  1764. order.
  1765.  
  1766. Adding Replaceable Parameters to Aliases
  1767.  
  1768. Command line arguments can be added to aliases using the same syntax as in
  1769. batch files. The above example could have been:
  1770.  
  1771. alias list dir %1 | sort
  1772.  
  1773. Then typing
  1774.  
  1775. c:\>list *.txt<ENTER>
  1776.  
  1777. would cause the %1 to be replaced by *.txt, causing list to produce a directory
  1778. of files ending in "txt" displayed in date order.
  1779.  
  1780. The special command line argument %* can also be added to aliases, which will
  1781. be replaced by all command line arguments.
  1782.  
  1783. Compound Aliases
  1784.  
  1785. Aliases can also be used to execute multiple commands using the command
  1786. separator character. For example, the alias definition
  1787.  
  1788. alias qp pushd d:\qpro^qpro %1^popd
  1789.  
  1790. defines the alias qp to mean "save the current directory, change directory to
  1791. d:\qpro, run qpro with the file specified on the command line, then restore the
  1792. directory to the original directory."
  1793.  
  1794. Nested Aliases
  1795.  
  1796. As mentioned earlier, aliases can be nested to any level. In other words, an
  1797. alias can contain an alias (which may contain another alias, and so on). For
  1798.  
  1799. Using TOP                                                                    4-9
  1800.  
  1801.  
  1802. TNC Technology                                                        TOP Manual
  1803.  
  1804. example if the following aliases were defined:
  1805.  
  1806. alias hello echo Hello
  1807. alias likec hello^echo World!
  1808.  
  1809. Typing likec at the command line would cause the message:
  1810.  
  1811. Hello
  1812. World!
  1813.  
  1814. Nested aliases are particularly useful for breaking up long unwieldy alias
  1815. definitions, or to add a repetitive routine to many other aliases
  1816.  
  1817. Preventing Recursive Expansion (Alias Loop Errors)
  1818.  
  1819. Aliases names are case sensitive, whereas DOS is not. You can use this feature
  1820. to define aliases which are variations of themselves, or to redefine commands
  1821. to have new meaning with the same name. For example, the alias definition:
  1822.  
  1823. alias dir dir %1 /od
  1824.  
  1825. would cause an error since the alias refers to itself. However, the alias
  1826. definition:
  1827.  
  1828. alias dir Dir %1 /od
  1829.  
  1830. will cause the DOS command DIR to be invoked with the /od switch whenever dir
  1831. is typed.
  1832.  
  1833. Removing Aliases
  1834.  
  1835. Aliases can be removed with the UNALIAS command. To remove the dir alias
  1836. defined above, type:
  1837.  
  1838. unalias dir
  1839.  
  1840. Examining or Saving Aliases
  1841.  
  1842. To examine the contents of the alias buffer, just type ALIAS at the command
  1843. prompt. To save the current alias buffer, redirect the output to a file, for
  1844. example:
  1845.  
  1846. c:\>alias > alias.txt<ENTER>
  1847.  
  1848. The above example saves the current alias buffer contents to a file named
  1849. alias.txt. Note that aliases can be automatically saved whenever they are
  1850. defined by setting the AliasAutoSaveFile entry in the [Initialize] section of
  1851. your TOP.INI file. See the chapter, "Customization and TOP.INI," for further
  1852. details.
  1853.  
  1854. Pre-loading Aliases / Reading an Alias File
  1855.  
  1856. Three methods are available to read in groups of aliases to pre-load or add
  1857. aliases to the alias buffer. First, the TOP.INI file contains a section called
  1858.  
  1859. Using TOP                                                                   4-10
  1860.  
  1861.  
  1862. TNC Technology                                                        TOP Manual
  1863.  
  1864. [Alias] which is a list of initial aliases to be assigned at startup. See the
  1865. chapter, "Customization and TOP.INI," for more details. This method is
  1866. generally used by TNC Technology to release interesting alias suggestions since
  1867. the TOP.INI file will be overwritten during installation. We therefore do not
  1868. advise you store your aliases using this method.
  1869.  
  1870. The second method of reading in aliases is to specify a filename using the
  1871. AliasAutoSaveFile entry in the [Initialize] section of your TOP.INI file. See
  1872. the chapter, "Customization and TOP.INI," for further details. Any aliases
  1873. defined in this file will have precedence over those defined in the TOP.INI
  1874. file. Also, this file will be updated anytime you define or remove an alias at
  1875. the command line, lending a permanence to your definitions. The release TOP.INI
  1876. file already has this parameter set, so no additional action is needed to use
  1877. this method.
  1878.  
  1879. Finally, groups of aliases can be read in by using the /r switch when typing
  1880. alias, followed by a file name containing the list of desired alias
  1881. definitions. For example, typing:
  1882.  
  1883. alias /r alias.txt
  1884.  
  1885. would append the aliases defined in the file alias.txt to the current alias
  1886. buffer contents (and automatically update the AliasAutoSaveFile).
  1887.  
  1888. Debugging Aliases
  1889.  
  1890. Aliases, unlike batch files, always operate with echo off. If you find your
  1891. alias is not operating correctly, and you can't see what's happening to figure
  1892. it out, you can enable alias debug mode by typing:
  1893.  
  1894. alias +
  1895.  
  1896. This will cause TOP to briefly display the expanded alias and each line to be
  1897. executed with command line parameters replaced just prior to execution as an
  1898. aid to debugging. For example, using the alias likec we defined earlier with
  1899. alias debug mode enabled would result in:
  1900.  
  1901. ALIAS: likec = hello^echo World!
  1902. ALIAS: hello = echo Hello
  1903. EXEC:  echo Hello
  1904. Hello
  1905. EXEC:  echo World!
  1906. World!
  1907.  
  1908. To disable alias debug mode, type:
  1909.  
  1910. alias -
  1911.  
  1912. The CRON Program Scheduler
  1913.  
  1914. One of the most innovative features of TOP, the CRON scheduler allows you to
  1915. set up a schedule of programs to occur periodically some time in the future.
  1916. All CRON events are set up using the TOP.INI file in the [Cron] section.
  1917.  
  1918.  
  1919. Using TOP                                                                   4-11
  1920.  
  1921.  
  1922. TNC Technology                                                        TOP Manual
  1923.  
  1924. Mandatory and Whimsical Entries
  1925.  
  1926. All CRON entries in the TOP.INI file are only executed during the time the
  1927. computer is otherwise idle and sitting at the command line waiting for input.
  1928. In other words, a CRON entry will not be executed in the middle of your word
  1929. processing session. To take advantage of this, there are two kinds of CRON
  1930. entries, called mandatory and whimsical. A mandatory entry is an entry which
  1931. will always be executed, either at the time it was scheduled, or, if the
  1932. computer is not idle or even off at that time, at the next available idle time.
  1933. A whimsical entry will only be executed if the computer is idle at the time
  1934. scheduled in the entry. Use mandatory entries for jobs which must occur
  1935. regardless of the time, such as backing up files to a network, or reminder
  1936. messages. Use whimsical entries for events which are time sensitive, such as
  1937. chimes on the quarter hour.
  1938.  
  1939. How To Make A CRON Entry
  1940.  
  1941. Each entry in the TOP.INI file consists of a time and date specification
  1942. followed by the name of the program to be executed. The time specification is a
  1943. sequence of numbers specifying the minute, hour, day-of-month, month, and day-
  1944. of-week to run the program, in that order. Any of the time specifications can
  1945. contain a single number, a range of numbers, a list of numbers, any combination
  1946. of lists and ranges, or a wildcard (*). See the chapter, "Customization and
  1947. TOP.INI," for more details. Either the day-of-month or the day-of week entry
  1948. can be true for CRON to execute the entry.
  1949.  
  1950. The time specification is then followed by the name of the program to be
  1951. executed. Any valid program name or command is acceptable, but remember to
  1952. specify the program path if it is not specified by your PATH environment
  1953. variable. If the program name is preceded by an equals sign (=), the entry is
  1954. whimsical, otherwise it is mandatory. This is really not as hard as it sounds,
  1955. as some examples will illustrate:
  1956.  
  1957. The above example would cause the message "Anniversary Today!" to be displayed
  1958. every hour on the hour all day on June 12 (so you for sure don't forget it).
  1959.  
  1960. 0 7 * * 1-5 getmail
  1961.  
  1962. This example would cause your computer to run the program getmail at 7:00 am
  1963. every weekday morning. Presumably you are not there to turn on the computer
  1964. until 8:20 am. That's OK, since it is a mandatory job CRON will execute it
  1965. then.
  1966.  
  1967. 45 16 * * 5 backup c:\*.txt e: /s
  1968.    < echo Y
  1969.  
  1970. Note: the above entry would be typed all on one line. This entry causes the DOS
  1971. program BACKUP to be executed every Friday afternoon at 4:45 pm. It causes all
  1972. files ending with .txt on drive c: to be backed up to network drive e:
  1973. automatically.
  1974.  
  1975. 0,15,30,45 * * * * =chime
  1976.  
  1977. This entry causes the program chime to be run every quarter hour. However,
  1978.  
  1979. Using TOP                                                                   4-12
  1980.  
  1981.  
  1982. TNC Technology                                                        TOP Manual
  1983.  
  1984. since it is a whimsical entry, it will only be run if the computer is idle at
  1985. that quarter hour.
  1986.  
  1987. 0,30 * * * * history > c:\history.txt
  1988.  
  1989. This entry causes the current history buffer to be saved to a file called
  1990. history.txt every half hour.
  1991.  
  1992. See also the chapter "Customization and TOP.INI," particularly the [Cron]
  1993. section, for more details of a CRON entry.
  1994.  
  1995. Displaying the Scheduled CRON JOBS
  1996.  
  1997. To display the currently scheduled CRON jobs, just type CRON at the command
  1998. prompt. To save the currently scheduled CRON jobs, redirect the output to a
  1999. file, for example:
  2000.  
  2001. c:\>cron > cron.txt<ENTER>
  2002.  
  2003. The above example saves the currently scheduled CRON jobs to a file named
  2004. cron.txt.
  2005.  
  2006. Resetting the CRON Clock Using CRON NOW
  2007.  
  2008. CRON remembers which job it is supposed to next execute by keeping an internal
  2009. "last executed" time clock. A copy of the last executed time is also saved to
  2010. the disk in the file specified by the CronTimeStamp entry in the [Initialize]
  2011. section of TOP.INI. This is so CRON can maintain a schedule of jobs to be
  2012. executed even through power off and boot times. The last executed time is
  2013. updated only after completion of a CRON job. There are conceivable but rare
  2014. situations where this is not desirable, for example if a CRON entry causes the
  2015. computer to purposely be booted (as might happen if network drivers needed to
  2016. be temporarily installed). Executing the command:
  2017.  
  2018. c:\>cron now<ENTER>
  2019.  
  2020. at the command line or in a CRON entry causes CRON to update its last executed
  2021. clock to the current time, thus cancelling execution of any pending jobs and
  2022. making CRON think it has completed the current job. Rebooting the computer at
  2023. this point will now not cause that job to be re-executed.
  2024.  
  2025. You may also want to use the CRON NOW command if you have just reset the time
  2026. or date of your system clock to prevent jobs from being re-run.
  2027.  
  2028. CRON Log Updates
  2029.  
  2030. Every time a scheduled non-whimsical CRON job has completed execution, an entry
  2031. will be appended to a log file giving you a dated record of scheduled jobs. The
  2032. log file is specified by the CronLogFile entry in the [Initialize] section of
  2033. TOP.INI. See the chapter, "Customization and TOP.INI," for more details. The
  2034. time and date of execution, and a copy of the CRON schedule entry are
  2035. continuously appended to this file, as well as the error code (if any) returned
  2036. by the scheduled program. This enables you to verify if a job was completed
  2037. successfully while you were not at your computer. Note: whimsical CRON jobs are
  2038.  
  2039. Using TOP                                                                   4-13
  2040.  
  2041.  
  2042. TNC Technology                                                        TOP Manual
  2043.  
  2044. not logged.
  2045.  
  2046. Debugging CRON Entries
  2047.  
  2048. Typing:
  2049.  
  2050. CRON always operates with echo off. If you find your cron job is not operating
  2051. correctly, and you can't see what's happening to figure it out, you can enable
  2052. cron debug mode by typing:
  2053.  
  2054. cron +
  2055.  
  2056. This will cause TOP to briefly display the cron job just prior to execution as
  2057. an aid to debugging.
  2058.  
  2059. To disable cron debug mode, type:
  2060.  
  2061. cron -
  2062.  
  2063. Typing CRON with no parameters will display the currently scheduled jobs.
  2064.  
  2065. Setting TOP's PROMPT: TOPPROMPT
  2066.  
  2067. TOPPROMPT is an environment variable used to set a new system prompt for TOP.
  2068. All the meta-string characters which are valid in the DOS PROMPT command are
  2069. valid as well in the TOPPROMPT variable, except the DOS meta-string characters
  2070. are now case sensitive. If the meta-string characters are capitalized the
  2071. result will be capitalized, otherwise the result will be lower case. In
  2072. addition, a few new meta-string characters have been added which TOP will
  2073. recognize and process. See the TOPPROMPT meta-string summary below.
  2074.  
  2075. Also, unlike the DOS PROMPT command, ANSI escape string sequences will be
  2076. recognized and processed even if ANSI.SYS is not installed (a summary of ANSI
  2077. escape sequences can be found in Appendix C). The TOPPROMPT string sequence is
  2078. executed every time a new prompt is issued. A sample TOPPROMPT setting which
  2079. uses the new meta-string characters and ANSI escape string sequences has been
  2080. included in your initial TOP.INI file.
  2081.  
  2082. TOPPROMPT can be set using either the SET or PROMPT command. For example:
  2083.  
  2084. PROMPT $p$T$g
  2085.  
  2086. sets TOPPROMPT to $p$T$q, which causes the current directory, then the current
  2087. time followed by the > character to be displayed as your prompt. This is
  2088. equivalent to:
  2089.  
  2090. SET TOPPROMPT=$p$T$g
  2091.  
  2092. The best place to put your prompt command is the [InitialCommands] section of
  2093. TOP.INI. See the chapter, "Customization and TOP.INI," for more details.
  2094.  
  2095. TOPPROMPT Meta-string Summary
  2096.  
  2097. The table below contains a list of all valid TOPPROMPT meta-strings. Both lower
  2098.  
  2099. Using TOP                                                                   4-14
  2100.  
  2101.  
  2102. TNC Technology                                                        TOP Manual
  2103.  
  2104. and upper case letters are accepted, and will result in lower or upper case
  2105. output (except t or T - see below).
  2106.  
  2107. Meta-    | Explanation
  2108. string   |
  2109. --------------------------------------------------
  2110. $$       | The $ character
  2111. --------------------------------------------------
  2112. $_       | A carriage return / line feed
  2113. --------------------------------------------------
  2114. $b       | The | character
  2115. --------------------------------------------------
  2116. $d       | The current date
  2117. --------------------------------------------------
  2118. $e       | ASCII code '1B' (the escape character)
  2119. --------------------------------------------------
  2120. $g       | The > character
  2121. --------------------------------------------------
  2122. $h       | A backspace
  2123. --------------------------------------------------
  2124. $l       | The < character
  2125. --------------------------------------------------
  2126. $m       | The time meridian (returns "am" or
  2127.          | "pm")
  2128. --------------------------------------------------
  2129. $n       | The current drive
  2130. --------------------------------------------------
  2131. $p       | The current directory of the current
  2132.          | drive
  2133. --------------------------------------------------
  2134. $q       | The = character
  2135. --------------------------------------------------
  2136. $s       | The current drive's available disk
  2137.          | space
  2138. --------------------------------------------------
  2139. $t       | The current time in 24 hour format
  2140. --------------------------------------------------
  2141. $T       | The current time in 12 hour format
  2142. --------------------------------------------------
  2143. $v       | The version number
  2144.  
  2145. The above table is also available on line by typing HELP PROMPT.
  2146.  
  2147. TOPTIME: The Time-Updated ANSI String
  2148.  
  2149. TOPTIME is similar to TOPPROMPT in that it is an environment variable
  2150. containing the same syntax of character strings, including the case sensitive
  2151. DOS meta-strings, ANSI escape string sequences (a SUMMARY of ANSI escape
  2152. sequences can be found in Appendix C), and the new TOP meta-strings in the
  2153. table above. However, TOPTIME is re-executed every second, independent of the
  2154. prompt. Naturally, this lends itself well to displaying the current time. A
  2155. sample TOPTIME setting which does just that has been included in your initial
  2156. TOP.INI file.
  2157.  
  2158.  
  2159. Using TOP                                                                   4-15
  2160.  
  2161.  
  2162. TNC Technology                                                        TOP Manual
  2163.  
  2164. TOPTIME can only be set using the SET command. For example:
  2165.  
  2166. SET TOPTIME=$T$m
  2167.  
  2168. sets TOPTIME to $T$m, which causes the current time in 12 hour format followed
  2169. by the time meridian to be displayed every second.
  2170.  
  2171. TOPDMT: Automatic Time-out Execution
  2172.  
  2173. TOPDMT is used to specify the name of the program to be executed when the
  2174. KeyboardTimeout time specified in the [Initialize] section of TOP.INI is
  2175. satisfied. TOPDMT must contain a valid executable program, including path
  2176. definition if required. Any user program can be specified by TOPDMT and it will
  2177. automatically be started after the idle time specified elapses (idle time is
  2178. when your computer is doing nothing else - i.e. when no programs are running
  2179. and the prompt is displayed). A typical program to be started is a "screen
  2180. saver", or something which temporarily blanks the screen and displays an
  2181. interesting picture instead. Several such programs have been included with your
  2182. TOP release. See also KeyboardTimeout in the [Initialize] section of TOP.INI
  2183. for more details. Also see Appendix D, "Using DMTs".
  2184.  
  2185. Keystroke Functions (FKEY)
  2186.  
  2187. Keystroke functions are user-defined command sequences which can are assigned
  2188. to a single keystroke. Keystroke functions are very similar to aliases and can
  2189. contain all the command and features that aliases use. The only difference
  2190. between aliases and keystroke functions is the keystroke function is pressed
  2191. after the arguments are typed on the command line - like calculator functions.
  2192.  
  2193. Keystroke functions are assigned using the FKEY command, and are removed using
  2194. the UNFKEY command. In addition, initial aliases can be defined in the TOP.INI
  2195. file in the [FunctionKeys] section.
  2196.  
  2197. The keystroke function name and argument length is only limited by the size of
  2198. the internal function key buffer, which is 64K bytes. All keystroke function
  2199. names and their arguments must fit in this buffer.
  2200.  
  2201. Like aliases, a keystroke function may contain any command or combination of
  2202. commands (using the command separator character). However, the total length of
  2203. a keystroke function must be less than 127 characters. If a longer keystroke
  2204. function is desired, first define an alias and assign it to a keystroke
  2205. function.
  2206.  
  2207. Keystroke functions cannot be nested, but may contain aliases which are nested.
  2208.  
  2209. Keystroke functions can be assigned to the keys F1 through F12, AltF1 through
  2210. AltF12, CtrlF1 through CtrlF12, ShiftF1 through ShiftF12, Alt0 through Alt9,
  2211. and AltA through AltZ. Note that assigning a keystroke function to any of F1
  2212. through F10 will supersede the default command line edit function for that key.
  2213.  
  2214. Adding Keystroke Functions
  2215.  
  2216. Keystroke functions are added in much the same way as aliases. For example,
  2217. typing
  2218.  
  2219. Using TOP                                                                   4-16
  2220.  
  2221.  
  2222. TNC Technology                                                        TOP Manual
  2223.  
  2224. defines the function key F12 to cause a directory listing to be displayed
  2225. listed in date order.
  2226.  
  2227. A replaceable parameter was included in the above example. Typing:
  2228.  
  2229. c:\>*.txt<F12>
  2230.  
  2231. would produce an date order directory of files ending in .txt.
  2232.  
  2233. Pre-loading Keystroke Functions / Reading a File
  2234.  
  2235. Three methods are available to read in groups of keystroke function definitions
  2236. to pre-load or add to the keystroke function buffer. First, the TOP.INI file
  2237. contains a section called [FunctionKeys] which is a list of all initial
  2238. keystroke functions to be assigned at startup. See the chapter, "Customization
  2239. and TOP.INI," for more details. This method is generally used by TNC Technology
  2240. to release interesting keystroke function suggestions since the TOP.INI file
  2241. will be overwritten during installation. We therefore do not advise you store
  2242. your keystroke functions using this method.
  2243.  
  2244. The second method of reading in keystroke functions is to specify a filename
  2245. using the FkeyAutoSaveFile entry in the [Initialize] section of your TOP.INI
  2246. file. See the chapter, "Customization and TOP.INI," for further details. Any
  2247. keystroke functions defined in this file will have precedence over those
  2248. defined in the TOP.INI file. Also, this file will be updated anytime you define
  2249. or remove a keystroke function at the command line, lending a permanence to
  2250. your definitions. The release TOP.INI file already has this parameter set, so
  2251. no additional action is needed to use this method.
  2252.  
  2253. Finally, groups of keystroke functions can be read in by using the /r switch
  2254. when typing fkey, followed by a file name containing the list of desired alias
  2255. definitions. For example, typing:
  2256.  
  2257. fkey /r function.txt
  2258.  
  2259. would append the keystroke functions defined in the file function.txt to the
  2260. current keystroke function buffer contents (and automatically update the
  2261. FkeyAutoSaveFile).
  2262.  
  2263. Removing Keystroke Functions
  2264.  
  2265. Keystroke functions can be removed with the UNFKEY command. To remove the F12
  2266. keystroke function defined above, type:
  2267.  
  2268. unfkey F12
  2269.  
  2270. Examining or Saving Keystroke Functions
  2271.  
  2272. To examine the contents of the keystroke function buffer, just type FKEY at the
  2273. command prompt. To save the current keystroke function buffer, redirect the
  2274. output to a file, for example:
  2275.  
  2276. c:\>fkey > function.txt<ENTER>
  2277.  
  2278.  
  2279. Using TOP                                                                   4-17
  2280.  
  2281.  
  2282. TNC Technology                                                        TOP Manual
  2283.  
  2284. The above example saves the current keystroke function buffer contents to a
  2285. file named function.txt.
  2286.  
  2287. Automatically Maintaining Colors
  2288.  
  2289. TOP automatically maintains DOS foreground, DOS background, and cursor color as
  2290. well as the current color palette. The colors are specified in the [Video] and
  2291. [Palette] sections of TOP.INI. See the chapter, "Customization and TOP.INI,"
  2292. for more details on setting colors.
  2293.  
  2294. Recursive Commands
  2295.  
  2296. TOP provides three new commands recursive through directories called MOVE, XDIR,
  2297.  and XDEL. Like DOS XCOPY, these commands provide file manipulation functions
  2298. across all or selected directories.
  2299.  
  2300. MOVE
  2301.  
  2302. MOVE is used to move or rename files, directories and directories containing
  2303. subdirectories. MOVE is much faster than COPY since only the location of the
  2304. files is changed; the files are not actually moved on the disk unless you
  2305. specify a MOVE to another drive.
  2306.  
  2307. The action taken by MOVE depends on the file parameters specified. If source
  2308. and destination are on the same disk, the files are moved. Otherwise the source
  2309. is copied to the destination disk, and the source is removed.
  2310.  
  2311. The action taken by MOVE also depends on the type of file parameters specified.
  2312. If the source parameter is a file specification, then only files are moved. If
  2313. the source is a path specification, then whole directories are moved. If a
  2314. destination is a directory and it does not exist, MOVE will create it for you
  2315. (after confirmation).
  2316.  
  2317. A few examples should make this clear. To rename a file, source and destination
  2318. are at the same path level:
  2319.  
  2320. c:\>move result.txt report.doc<ENTER>
  2321.  
  2322. The above example just renames the file result.txt to report.doc, unless
  2323. report.doc already exits (otherwise confirmation will be requested to delete
  2324. and replace report.doc).
  2325.  
  2326. To move a file to another directory:
  2327.  
  2328. c:\text>move result.txt \wp<ENTER>
  2329.  
  2330. The above example moves the file result.txt to the directory \wp if \wp exits,
  2331. otherwise \wp is created for you first (after confirmation).
  2332.  
  2333. Wildcards are accepted in the source, if the destination is a directory. If a
  2334. wildcard operator had been specified in the previous example, such as:
  2335.  
  2336. c:\text>move *.txt \wp<ENTER>
  2337.  
  2338.  
  2339. Using TOP                                                                   4-18
  2340.  
  2341.  
  2342. TNC Technology                                                        TOP Manual
  2343.  
  2344. all files matching *.txt in \text would be moved to \wp if \wp exits, otherwise
  2345. \wp is created for you first (after confirmation).
  2346.  
  2347. To rename a directory, source and destination are at the same path level:
  2348.  
  2349. c:\>move \text \wp<ENTER>
  2350.  
  2351. would just rename the directory \text to \wp if \wp did not already exist (if
  2352. \wp did exist then \text and all files and directories in it would be moved
  2353. there), but typing:
  2354.  
  2355. c:\>move \text \wp\text<ENTER>
  2356.  
  2357. would move the entire contents of the \text directory to the subdirectory
  2358. \wp\text contained in \wp, (and/or create the \wp\text directory first if it
  2359. did not exist after confirmation).
  2360.  
  2361. If a destination file exists, a confirmation is requested to delete it before
  2362. the move occurs. However, the switch /NOCONF causes MOVE to overwrite existing
  2363. destinations without confirmation. USE WITH CARE! Using /NOCONF does not
  2364. disable confirmation if a new directory is to be created.
  2365.  
  2366. MOVE normally displays each file name as it is moved. If you do not want to see
  2367. each filename displayed, for example if MOVE were part of an ALIAS command, the
  2368. /Q switch can be used. /Q runs MOVE quietly, with only summary information
  2369. echoed to the display.
  2370.  
  2371. MOVE normally verifies each file move with the DOS write verify function if
  2372. verify is set to on. TOP will perform additional verification before deleting
  2373. the source files if a /V switch is included. Including /V will cause MOVE to
  2374. take slightly longer, but will provide an extra measure of confidence that
  2375. files were written or moved properly.
  2376.  
  2377. MOVE also accepts the /! switch (as do many TOP functions), which will cause
  2378. all BUT the specified files to be moved. For example,
  2379.  
  2380. c:\>move *.txt \wp\other /! <ENTER>
  2381.  
  2382. will cause all files except those ending in txt in the current directory to be
  2383. moved to the directory \wp\other.
  2384.  
  2385. MOVE normally does not move hidden files. Including the /H switch will allow
  2386. MOVE to move hidden files as well.
  2387.  
  2388. Disk space is never a problem when moving files within a drive since they fit
  2389. in the first place, but if MOVE runs out of space when moving across drives it
  2390. will exit.
  2391.  
  2392. XDEL
  2393.  
  2394. XDEL is used to delete a file or group of files in a specified path and all
  2395. subpaths. XDEL can even delete an entire directory and all files and
  2396. subdirectories in it. USE THIS FEATURE WITH CARE!!
  2397.  
  2398.  
  2399. Using TOP                                                                   4-19
  2400.  
  2401.  
  2402. TNC Technology                                                        TOP Manual
  2403.  
  2404. The action taken by XDEL depends on the type of file parameters specified. If
  2405. the parameter is a file specification, then only files are deleted. If the file
  2406. parameter is a path specification, then whole directories are deleted. XDEL can
  2407. accept multiple file parameters and will act on them individually depending on
  2408. what type they are.
  2409.  
  2410. XDEL is used like DOS DEL, except the parameter specified may also be a
  2411. directory. XDEL always deletes all matching files in the directory specified
  2412. and in all subdirectories of that directory. If you only want to delete the one
  2413. file you are specifying, do not use XDEL, use DEL. For example:
  2414.  
  2415. c:\>xdel \*.bak<ENTER>
  2416.  
  2417. would cause all files matching *.bak to be deleted from the entire drive. XDEL
  2418. also accepts multiple parameters. Fore example typing:
  2419.  
  2420. c:\>xdel \*.bak \*.tmp<ENTER>
  2421.  
  2422. would cause all files matching *.bak and *.tmp to be deleted from the entire
  2423. drive.
  2424.  
  2425. The scope of XDEL in the previous examples was the entire drive since it was
  2426. executed from the root directory with no path specification. If instead the
  2427. following were typed:
  2428.  
  2429. c:\>xdel \text\*.bak<ENTER>
  2430.  
  2431. or
  2432.  
  2433. c:\text>xdel *.bak<ENTER>
  2434.  
  2435. then XDEL would delete all files matching *.bak in the directory \TEXT and all
  2436. files matching *.bak in all subdirectories of \TEXT. Finally, typing:
  2437.  
  2438. c:\>xdel \text<ENTER>
  2439.  
  2440. would delete the directory \TEXT and all files and subdirectories in it.
  2441.  
  2442. Normally, XDEL will not delete read-only files. However, if the switch /R is
  2443. included with the XDEL command, read-only files will be deleted as well.
  2444.  
  2445. XDEL normally displays each file name as it is deleted. If you do not want to
  2446. see each filename displayed, for example if XDEL were part of an ALIAS command,
  2447. the /Q switch can be used. /Q runs XDEL quietly, with only summary information
  2448. echoed to the display. /Q will also make XDEL run considerably faster since
  2449. files will be deleted in blocks instead of individually.
  2450.  
  2451. Because of the potential for deleting many files in one stroke, XDEL never
  2452. proceeds without echoing what you asked for and asking for confirmation.
  2453. However, the switch /NOCONF causes XDEL to proceed without confirmation. USE
  2454. THIS FEATURE WITH EXTREME CARE!!
  2455.  
  2456. XDEL also accepts the /! switch (as do many TOP functions), which will cause
  2457. all BUT the specified files to be deleted. For example,
  2458.  
  2459. Using TOP                                                                   4-20
  2460.  
  2461.  
  2462. TNC Technology                                                        TOP Manual
  2463.  
  2464. c:\>xdel \temp\*.zip /! <ENTER>
  2465.  
  2466. will cause all files except those ending in zip to be deleted in the directory
  2467. \temp and its subdirectories. Needless to say this feature is powerful, but
  2468. potentially can delete a large number of files. USE THIS FEATURE WITH CARE!
  2469.  
  2470. XDEL normally will not delete hidden, read only, or system files. Including any
  2471. or all of the switches /H, /R, or /S will allow XDEL to delete hidden, read
  2472. only, or system files, respectfully. USE THIS FEATURE WITH CARE!
  2473.  
  2474. XDEL also accepts a /P switch, which will cause XDEL to pause and ask for
  2475. confirmation before deleting each file specified. Use of /P overrides /Q or
  2476. /NOCONF.
  2477.  
  2478. XDIR
  2479.  
  2480. XDIR will list (or find) all or specified directory entries in a path and all
  2481. its subpaths. XDIR is used like DOS DIR, except the files displayed will be
  2482. from the specified directory and all subdirectories. For example:
  2483.  
  2484. c:\>xdir \*.txt
  2485.  
  2486. will list all files matching *.txt on the entire drive. Including the \ above
  2487. insures the root directory is searched, even if this were not your current
  2488. directory. This can be particularly useful if you were trying to find a file
  2489. ending in .txt but you didn't know where it was.
  2490.  
  2491. The action taken by XDIR depends on the type of file parameters specified. If
  2492. the source parameter is a file specification, then all matching files are
  2493. displayed. If the source is just a path specification, then directories and
  2494. subdirectories are displayed. For example, typing:
  2495.  
  2496. c:\>xdir \wp\*.*<ENTER>
  2497.  
  2498. will list all files in the directory \wp and in its subdirectories. However,
  2499. typing:
  2500.  
  2501. c:\>xdir \wp<ENTER>
  2502.  
  2503. will list all subdirectories in the directory \wp. This is particularly useful
  2504. in conjunction with the /V switch (see below).
  2505.  
  2506. XDIR will list matching files with their complete path names, or just
  2507. directories if only a path is specified. If the /V (verbose) switch is included,
  2508.  XDIR also displays file date and size. This is particularly useful when
  2509. displaying only directories as the file usage will be displayed for each
  2510. directory. Typing:
  2511.  
  2512. c:\>xdir \ /V| sort /r | view
  2513.  
  2514. will produce a list of all directories on your drive, sorted by file space
  2515. usage, displayed in the TOP view window. Try it! The above example makes a
  2516. great alias too.
  2517.  
  2518.  
  2519. Using TOP                                                                   4-21
  2520.  
  2521.  
  2522. TNC Technology                                                        TOP Manual
  2523.  
  2524. XDIR also accepts the /! switch (as do many TOP functions), which will cause
  2525. all BUT the specified files to be displayed. For example,
  2526.  
  2527. c:\>xdir \temp\*.zip /! <ENTER>
  2528.  
  2529. will cause all files except those ending in zip to be listed.
  2530.  
  2531. XDIR normally displays all but hidden files. Using the /H switch will allow
  2532. display of hidden files as well.
  2533.  
  2534. Two other switches are available for XDIR, /P and /Q. /P will pause the screen
  2535. display when full, and /Q runs quietly, displaying only summary information to
  2536. the display
  2537.  
  2538. Examine File Contents: VIEW
  2539.  
  2540. VIEW displays the contents of any file in a TOP window. Unlike using type, the
  2541. VIEW is a TOP window function and can be scrolled, sized, and moved. As with
  2542. any TOP window, right mouse clicks or drags can highlight any displayed text
  2543. for subsequent pasting to the command line or other windows.
  2544.  
  2545. VIEW can be started by selecting VIEW from the mouse pop-up chord menu. The
  2546. filename to be VIEWed can be dragged into the VIEW window (using the left mouse
  2547. button) from either the FILES or LIST window (see the chapter "Using the Mouse
  2548. and TOP Windows"). Alternatively, VIEW can be started by typing:
  2549.  
  2550. view [filename]
  2551.  
  2552. at the command prompt.
  2553.  
  2554. The VIEW window's initial position, initial size, initial state (on or off),
  2555. and use of colors is controlled by modifying the [ViewWindow] section in
  2556. TOP.INI. See the chapter "Customization and TOP.INI" for more details.
  2557.  
  2558. Piping into VIEW
  2559.  
  2560. Program output can be piped to VIEW using the DOS pipe symbol (|). You can then
  2561. VIEW the output from your program at leisure by scrolling the VIEW window. For
  2562. example, typing:
  2563.  
  2564. dir | view
  2565.  
  2566. will pipe the output from dir into the view window.
  2567.  
  2568. Change Drive and Directory: CDD
  2569.  
  2570. CDD changes or displays the current drive and directory simultaneously. It is
  2571. equivalent, but faster and more convenient than the two commands CD and d:. For
  2572. example:
  2573.  
  2574. c:\>cdd d:\qp
  2575.  
  2576. changes the drive to drive D: and the current directory on D: to \QP. Typing
  2577. CDD with no parameters just displays the current drive and directory.
  2578.  
  2579. Using TOP                                                                   4-22
  2580.  
  2581.  
  2582. TNC Technology                                                        TOP Manual
  2583.  
  2584. Save and Recall the Current Directory: PUSHD, POPD
  2585.  
  2586. PUSHD is used to push (save) the current drive and directory into a directory
  2587. stack and optionally change the current drive and directory at the same time.
  2588. It is used in conjunction with POPD, which returns the drive and directory to
  2589. the state saved with PUSHD. For example:
  2590.  
  2591. c:\wp>pushd d:\spreadsh\wk
  2592.  
  2593. d:\spreadsh\wk>
  2594.  
  2595. Some time later type:
  2596.  
  2597. d:\spreadsh\wk>popd
  2598.  
  2599. c:\wp>
  2600.  
  2601. If no drive or directory is specified, PUSHD will just push the current
  2602. directory without changing directories.
  2603.  
  2604. The directory stack saved with PUSHD is restored by POPD on a last in first out
  2605. basis. To display the current directory stack, use the TOP command DIRS.
  2606.  
  2607. There is virtually no limit to the number of directories that can be saved with
  2608. PUSHD (it depends on the length of the path saved, but several hundred at
  2609. least).
  2610.  
  2611. Extended VGA Modes
  2612.  
  2613. So you own a super VGA card. You read the manual, it said you have all kinds of
  2614. extended text modes you can run it in. You switched into one of them, maybe the
  2615. 132 column by 43 row mode. What happened? You typed dir and it started
  2616. scrolling at the 25th line! The sad fact is, most DOS utilities have that 25
  2617. line parameter hard coded in, so they will never work with those extended modes
  2618. you paid extra to have.
  2619.  
  2620. So what to do? Ask the little guy in the margin! TOP not only fully supports
  2621. all extended VGA text modes of most popular super VGA cards, but maintains the
  2622. mode of your choice even when other programs you run reset it.
  2623.  
  2624. Using these modes is quite simple. Using TOP's setup utility, TOPSU, change the
  2625. VideoMode entry in the [Video] section (see the chapter "Customization and
  2626. TOP.INI" for more details). The mode you select will be maintained permanently
  2627. while TOP is in control.
  2628.  
  2629. If you have already been using some form of EGA 43 line or VGA 50 line mode,
  2630. using DOS 4.0+ and the MODE command, you must know that DOS requires ANSI.SYS
  2631. to be loaded to support these modes. TOP does not require ANSI.SYS to run in
  2632. these modes and if there is no other reason for ANSI.SYS you can optionally
  2633. remove it from your CONFIG.SYS file. Since TOP does not require ANSI.SYS for
  2634. anything else, including complete support of complex ANSI prompt strings, you
  2635. might as well remove it and consequently save some additional memory.
  2636.  
  2637. For extended VGA modes, see the file README.VGA that came with your release for
  2638.  
  2639. Using TOP                                                                   4-23
  2640.  
  2641.  
  2642. TNC Technology                                                        TOP Manual
  2643.  
  2644. up to date information on mode numbers and capabilities of your particular
  2645. video card. For extended VGA modes, DOS's ANSI.SYS must be removed as it does
  2646. not support any extended VGA modes. Again, TOP fully supports these modes and
  2647. it is unlikely you will need ANSI. If you absolutely have to have ANSI.SYS
  2648. loaded, you cannot use the extended VGA modes, but you can still take advantage
  2649. of EGA 43 or VGA 50 line modes.
  2650.  
  2651. See the chapter "Customization and TOP.INI" for more details. Finally a way to
  2652. use those extended modes!
  2653.  
  2654. Handling Programs Lacking VGA Support
  2655.  
  2656. Amazingly, even though VGA extended modes have been around a fairly long time,
  2657. there are still a lot of applications around that do not take advantage of
  2658. them. Many older programs even have the same problem as DOS in that they assume
  2659. your screen is in a 25 line text mode and when they start up, they do not
  2660. verify or set it!
  2661.  
  2662. To help you solve this problem, TOP includes a fast video mode setting utility,
  2663. called VIDEO, which you can use to quickly set the mode prior to running these
  2664. programs. Since TOP always restores the mode after any program is run, you must
  2665. include the VIDEO command in a compound command, alias, fkey, or batch file.
  2666. For example, suppose you find your favorite editor only seems to work in a 25
  2667. line mode. You might type:
  2668.  
  2669. c:\>video co80 ^ editor<ENTER>
  2670.  
  2671. Or you could define an alias, called ed:
  2672.  
  2673. c:\>alias ed video co80^editor %*
  2674.  
  2675. and always start your editor using the alias.
  2676.  
  2677. Using Multiple Parameters With Commands
  2678.  
  2679. Many TOP commands accept multiple file parameters allowing you to group
  2680. otherwise unrelated commands into a single command. The commands which accept
  2681. multiple parameters are ATTRIB, DEL, DIR, ERASE, XDEL, and XDIR. For example,
  2682. typing
  2683.  
  2684. dir *.txt *.doc
  2685.  
  2686. will list all files ending with txt and all files ending with doc.
  2687.  
  2688. Using Enhanced Wildcards
  2689.  
  2690. Wildcards are used to specify a group of related files so you don't have to use
  2691. the same command repeatedly for each filename in the group. Wildcards are
  2692. special characters which act as a substitute for other characters in a filename
  2693. or extension. There are two such characters:
  2694.  
  2695. The * character represents any number of characters, including NO characters,
  2696. one character, two characters, etc.
  2697.  
  2698.  
  2699. Using TOP                                                                   4-24
  2700.  
  2701.  
  2702. TNC Technology                                                        TOP Manual
  2703.  
  2704. The ? character represents exactly ONE character.
  2705.  
  2706. However, DOS only recognizes one * in the filename, and one in the extension.
  2707. Any characters typed after the * are ignored. This can lead to confusing and
  2708. unexpected results.
  2709.  
  2710. Luckily, all TOP commands accept "enhanced" wildcards. Enhanced wildcards are
  2711. considerably more flexible than DOS wildcards and do not have the limitations
  2712. described above. For example:
  2713.  
  2714. dir *r*.*
  2715.  
  2716. Will list all files containing an r anywhere in the name in the current
  2717. directory. In contrast, given the example above, DOS would ignore the filename
  2718. characters after the first * and therefore list ALL files. More examples:
  2719.  
  2720. del *.txt
  2721.  
  2722. would delete all files ending in txt in the current directory.
  2723.  
  2724. attrib my*.* -r
  2725.  
  2726. would clear the READ attribute from all files starting with my in the current
  2727. directory.
  2728.  
  2729. dir *.*q*
  2730.  
  2731. would list all files with a q in the extension (DOS would just list ALL files).
  2732.  
  2733. del *my*.??
  2734.  
  2735. would delete all files with my anywhere in the filename and which had exactly
  2736. two characters in the extension (DOS would delete ALL files with exactly two
  2737. characters in the extension)
  2738.  
  2739. NISTIME
  2740.  
  2741. NISTIME is a utility which uses your Hayes(tm) compatible modem to dial the
  2742. National Institute of Standards and Technology's (NIST) Automated Computer Time
  2743. Service (ACTS), retrieves the time and date, and sets your PC clock. A
  2744. proprietary algorithm was employed to synchronize the PC's clock as precisely
  2745. as possible resulting in a typical setting error of less than +/-1 ms. This
  2746. utility is controlled by modifying the [Nistime] section in TOP.INI. See the
  2747. [NISTIME] section of the chapter "Customization and TOP.INI" for more details
  2748. on changing the setup for NISTIME.
  2749.  
  2750. After modifying the appropriate settings in your TOP.INI file (to indicate
  2751. choice of com port and etc.), to use NISTIME just type:
  2752.  
  2753. c:\>nt<ENTER>
  2754.  
  2755. (nt is a supplied example alias which calls NISTIME with the appropriate path
  2756. specification). NISTIME reports its progress as it dials ACTS, then sets your
  2757. PC's clock.
  2758.  
  2759. Using TOP                                                                   4-25
  2760.  
  2761.  
  2762. TNC Technology                                                        TOP Manual
  2763.  
  2764. Automatic Command Line Completion
  2765.  
  2766. While typing at the command line, pressing the <TAB> key will insert a filename
  2767. from the current directory at the cursor. Repeated <TAB> presses will
  2768. alphabetically cycle through all files in the directory, or <Shift-TAB> will
  2769. reverse alphabetically cycle. If the cursor is on a partly typed filename or
  2770. file specification using wildcards, repeated <TAB> presses will cycle through a
  2771. list of matching files in the current directory.
  2772.  
  2773. Since TOP must first read in all files to sort them at the first press of the
  2774. <TAB> key, you may notice a slight but perceptible delay if you are in a
  2775. directory containing an enormous number of files.
  2776.  
  2777.  
  2778.  
  2779.  
  2780.  
  2781.  
  2782.  
  2783.  
  2784.  
  2785.  
  2786.  
  2787.  
  2788.  
  2789.  
  2790.  
  2791.  
  2792.  
  2793.  
  2794.  
  2795.  
  2796.  
  2797.  
  2798.  
  2799.  
  2800.  
  2801.  
  2802.  
  2803.  
  2804.  
  2805.  
  2806.  
  2807.  
  2808.  
  2809.  
  2810.  
  2811.  
  2812.  
  2813.  
  2814.  
  2815.  
  2816.  
  2817.  
  2818.  
  2819. Using TOP                                                                   4-26
  2820.  
  2821. ################################################################################
  2822. ################################################################################
  2823.  
  2824.  
  2825.  
  2826.  
  2827.  
  2828.  
  2829.  
  2830.  
  2831.  
  2832.  
  2833.  
  2834.  
  2835.  
  2836.  
  2837.  
  2838.  
  2839.  
  2840.  
  2841.  
  2842.  
  2843.  
  2844.  
  2845.  
  2846.  
  2847.  
  2848.  
  2849.  
  2850.                                   Chapter 5
  2851.                        Using the Mouse and TOP Windows
  2852.  
  2853.  
  2854.  
  2855.  
  2856.  
  2857.  
  2858.  
  2859.  
  2860.  
  2861.  
  2862.  
  2863.  
  2864.  
  2865.  
  2866.  
  2867.  
  2868.  
  2869.  
  2870.  
  2871.  
  2872.  
  2873.  
  2874.  
  2875.  
  2876.  
  2877.  
  2878. ################################################################################
  2879. ################################################################################
  2880.  
  2881.  
  2882. TNC Technology                                                        TOP Manual
  2883.  
  2884. Using the Mouse and TOP Windows
  2885.  
  2886. Many TOP commands are conveniently available through the use of your mouse.
  2887. Your mouse must be Microsoft(tm) compatible and have at least two buttons (if
  2888. your mouse has more buttons, only the left most and right most buttons will be
  2889. used). A Microsoft(tm) mouse compatible driver must be loaded and running.
  2890.  
  2891. While a mouse is not absolutely necessary to use TOP, the power it unleashes
  2892. makes it highly recommended!
  2893.  
  2894. A Short Discussion on Mouse Clicks
  2895.  
  2896. No, they're not small groups of "in" mice. TOP recognizes five kinds of mouse
  2897. button actions, which will be defined here and used though this section. The
  2898. mouse actions are summarized in the table below.
  2899.  
  2900. Mouse       | Definition
  2901. Action      |
  2902. --------------------------------------------------
  2903. Click       | Quickly press and release a mouse
  2904.             | button
  2905. --------------------------------------------------
  2906. Press       | Press and hold a mouse button
  2907. --------------------------------------------------
  2908. Drag        | Press and hold a mouse button, then
  2909.             | move the mouse
  2910. --------------------------------------------------
  2911. Double      | Quickly press and release a mouse
  2912. Click       | button twice in succession
  2913. --------------------------------------------------
  2914. Chord       | Press and hold both the LEFT and
  2915.             | RIGHT mouse button together
  2916.  
  2917. The above will usually be preceded by the word "Left" or "Right" meaning the
  2918. left or right mouse button, respectively.
  2919.  
  2920. TOP Mouse Commands
  2921.  
  2922. Since by now you've probably started TOP, you've already noticed that there's a
  2923. live mouse cursor on your screen. The mouse is used in two primary ways: To
  2924. operate TOP window functions, and to cut and paste text from anywhere on the
  2925. screen to the command line. These two functions have been divided up between
  2926. the left and right mouse buttons. The table below summarizes the mouse commands
  2927. available at any time:
  2928.  
  2929. Mouse    | Left Button        | Right Button
  2930. Action   | In general: Used   | In general:
  2931.          | to operate windows;| Selects any
  2932.          |  used to copy      | visable text from
  2933.          | selected text      | anywhere on the
  2934.          | between windows    | screen
  2935.          | and/or to the      |
  2936.          | command line       |
  2937. ---------------------------------------------------
  2938.  
  2939. Using the Mouse and TOP Windows                                              5-2
  2940.  
  2941.  
  2942. TNC Technology                                                        TOP Manual
  2943.  
  2944. Click    | Select a window    | Highlight the word
  2945.          | function option.   | under the mouse
  2946.          | See "TOP Window    | cursor. Use a Left-
  2947.          | Functions -        | Drag to copy the
  2948.          | General Usage"     | highlighted word
  2949.          | below. Also moves  | to a window or the
  2950.          | the command line   | command line
  2951.          | cursor             |
  2952. ---------------------------------------------------
  2953. Drag     | Drag window        | Controlled
  2954.          | selection or right | highlight (drag
  2955.          | button highlight   | mouse cursor over
  2956.          | to the command     | any desired screen
  2957.          | line or to another | text). Use a Left-
  2958.          | window             | Drag to copy the
  2959.          |                    | highlighted text
  2960.          |                    | to a window or the
  2961.          |                    | command line
  2962. ---------------------------------------------------
  2963. Double   | Select a window    | Highlight the word
  2964. Click    | option, paste it   | under the mouse
  2965.          | to the command     | cursor, paste it
  2966.          | line at the cursor,| to the command
  2967.          |  and immediately   | line at the cursor,
  2968.          | execute the        |  and immediately
  2969.          | resulting command  | execute the
  2970.          | line               | resulting command
  2971.          |                    | line
  2972. ---------------------------------------------------
  2973. Chord    | Pop up the window control menu. Menu
  2974.          | choices are: CloseAll, SaveLayout,
  2975.          | Alias, Files, History, List, View, and
  2976.          | Help. To select an item, move the mouse
  2977.          | over the item desired and release the
  2978.          | chord.
  2979.  
  2980. The above table can be accessed online by typing HELP wMOUSE, or just type
  2981. wMOUSE and press <F1>. All HELP for TOP mouse and window functions generally
  2982. start with a little w.
  2983.  
  2984. While the above table may at first seem complicated when read, it cannot be
  2985. overemphasized how simple and convenient it will seem in practice!
  2986.  
  2987. The Chord Pop-Up Menu
  2988.  
  2989. Chording the mouse (see table above) brings up a pop-up menu containing the
  2990. following window function choices: CloseAll, SaveLayout, Alias, Files, History,
  2991. List, View, and Help. The chord pop-up menu is global, in other words it is
  2992. always available when TOP is running, and it affects all functions equally. The
  2993. table below explains the chord pop-up menu functions:
  2994.  
  2995. Pop-up    | Explanation
  2996. menu item |
  2997. -------------------------------------------------
  2998.  
  2999. Using the Mouse and TOP Windows                                              5-3
  3000.  
  3001.  
  3002. TNC Technology                                                        TOP Manual
  3003.  
  3004. CloseAll  | Closes all TOP window functions
  3005. -------------------------------------------------
  3006. SaveLayout| Save the position and size of all
  3007.           | TOP windows
  3008. -------------------------------------------------
  3009. Alias     | Opens the ALIAS window, or brings it
  3010.           | to the top
  3011. -------------------------------------------------
  3012. Files     | Opens the FILES window, or brings it
  3013.           | to the top
  3014. -------------------------------------------------
  3015. History   | Opens the HISTORY window, or brings
  3016.           | it to the top
  3017. -------------------------------------------------
  3018. List      | Opens the LIST window, or brings it
  3019.           | to the top
  3020. -------------------------------------------------
  3021. View      | Opens the VIEW window, or brings it
  3022.           | to the top
  3023. -------------------------------------------------
  3024. Help      | Opens the HELP window, or brings it
  3025.           | to the top
  3026.  
  3027. TOP Window Functions
  3028.  
  3029. TOP window functions are simple, convenient ways to speed up and simplify
  3030. access to or creation of your commands. For example, HELP is a TOP window
  3031. function. Other TOP window functions are ALIASES, FILES, HISTORY, LIST, and
  3032. VIEW, all described below.
  3033.  
  3034. General Usage
  3035.  
  3036. This section describes the common features of all TOP window functions and how
  3037. to use them. Specific information for individual TOP windows is presented later
  3038. in this chapter.
  3039.  
  3040. All TOP window functions can be started with the chord pop-up menu (see above),
  3041. and can be cancelled by clicking the left mouse button on the close box in the
  3042. upper left corner of each window (the small square dot enclosed in square
  3043. brackets). Once opened a window will remain open until it is closed, or it can
  3044. close itself (autoclose) when a command is executed. The choice to autoclose is
  3045. made in the appropriate section of TOP.INI. See the chapter "Customization and
  3046. TOP.INI" for more details.
  3047.  
  3048. TOP windows can be moved and sized. To move a window, place the mouse cursor
  3049. anywhere on the title bar and press the left button. Move the window to the
  3050. desired location and release the mouse. To size a window, place the mouse
  3051. cursor anywhere on the window's boarder or corner and press the left button.
  3052. Stretch the window to the desired size and release the mouse. The new position
  3053. and size can be permanently saved using the SaveLayout command from the chord
  3054. pop-up menu.
  3055.  
  3056. TOP windows can also be maximized, or made as big as the screen will allow, by
  3057. clicking the left mouse button on the maximize box in the upper right corner of
  3058.  
  3059. Using the Mouse and TOP Windows                                              5-4
  3060.  
  3061.  
  3062. TNC Technology                                                        TOP Manual
  3063.  
  3064. the window (the small up and down arrow enclosed in square brackets). Pressing
  3065. the maximize box again after a window is full size will return the window to
  3066. its former size.
  3067.  
  3068. When all items to be displayed do not fit in a TOP window, scroll bars are
  3069. activated on the right and/or bottom side of the window. The scroll bar
  3070. consists of small up and down or left and right arrows, and a relative position
  3071. indicator. The scroll bars are actuated with the left mouse button in two ways:
  3072. pressing or clicking on the arrows scrolls the text up or down a line at a time;
  3073.  dragging the left button on the relative position indicator moves the view
  3074. directly to that relative point.
  3075.  
  3076. A click on any place in a window not associated with any other function (such
  3077. as the boarder or background) brings that window to the front if it is partly
  3078. obscured by any other window. A window can also be brought to the front at any
  3079. time by reselecting it from the chord pop-up menu.
  3080.  
  3081. All TOP windows have an associated section in the TOP.INI file which controls
  3082. their initial position, initial size, initial state (on or off), autoclose
  3083. ability, and use of colors. See the chapter "Customization and TOP.INI" for
  3084. more details.
  3085.  
  3086. Using TOP Windows Without a Mouse
  3087.  
  3088. A keyboard interface is available to let you use TOP windows if you do not have
  3089. a mouse. The keys are shown in the table below:
  3090.  
  3091. Key                     | Function
  3092. --------------------------------------------------
  3093. <Alt F6>                | Change active window
  3094.                         | (highlights title)
  3095. --------------------------------------------------
  3096. <Alt F4>                | Close active window
  3097. --------------------------------------------------
  3098. <Ctrl PGUP>             | Scroll active window up
  3099.                         | one page
  3100. --------------------------------------------------
  3101. <Ctrl PGDN>             | Scroll active window
  3102.                         | down one page
  3103. --------------------------------------------------
  3104. <Ctrl HOME>             | Scroll active window to
  3105.                         | top
  3106. --------------------------------------------------
  3107. <Ctrl END>              | Scroll active window to
  3108.                         | bottom
  3109. --------------------------------------------------
  3110. <Ctrl Left Arrow>       | Scroll active window
  3111.                         | left
  3112. --------------------------------------------------
  3113. <Ctrl Right Arrow>      | Scroll active window
  3114.                         | right
  3115. --------------------------------------------------
  3116. <Ctrl Up Arrow>         | Scroll active window up
  3117. --------------------------------------------------
  3118.  
  3119. Using the Mouse and TOP Windows                                              5-5
  3120.  
  3121.  
  3122. TNC Technology                                                        TOP Manual
  3123.  
  3124. <Ctrl Down Arrow>       | Scroll active window
  3125.                         | down
  3126.  
  3127. The "active" window is the window in the front, and will be indicated by a
  3128. highlighted title.
  3129.  
  3130. Keyboard users do not have access to the Alias, Files, History, or List
  3131. windows.
  3132.  
  3133. Moving Selections Between Windows and the Command Line
  3134.  
  3135. In addition to dragging text or selections from any window to the command line,
  3136. some TOP windows also accept selections from the screen or other windows. In
  3137. other words, you can drag selections into a window as well as out of a window.
  3138. The table below summarizes the relationship between all TOP windows.
  3139.  
  3140. Window          | Imports         | Exports
  3141.                 | (dragged into)  | (Left button
  3142.                 |                 | select)
  3143. ----------------------------------------------------
  3144. ALIAS           | none            | Command
  3145. ----------------------------------------------------
  3146. FILES           | none            | File name with
  3147.                 |                 | complete path
  3148. ----------------------------------------------------
  3149. HELP            | Help topic      | Any word
  3150. ----------------------------------------------------
  3151. HISTORY         | none            | Command
  3152. ----------------------------------------------------
  3153. LIST            | Path            | File name
  3154.                 | specification   | without path
  3155. ----------------------------------------------------
  3156. VIEW            | File name       | Line in file
  3157.  
  3158. If a selection is already highlighed and the window is selected from the chord
  3159. pop-up menu, it is equivelent to dragging the selection into that window.
  3160.  
  3161. ALIAS Window
  3162.  
  3163. Selecting ALIAS from the chord menu brings up the ALIAS window containing a
  3164. list of all currently defined aliases. While this window is active, a left
  3165. click on any item in the window selects that item for export. A left drag
  3166. copies the selected item to the command line at the command cursor or to any
  3167. other TOP window. In addition, a left double click on any item will select the
  3168. item, copy it to the command line at the command cursor, and execute the
  3169. resulting command line in one action.
  3170.  
  3171. The ALIAS window can be moved and sized (see "TOP Window Functions - General
  3172. Usage"). Left clicking the close box will cancel the ALIAS window.
  3173.  
  3174. The ALIAS window's initial position, initial size, initial state (on or off),
  3175. autoclose function, and use of colors is controlled by modifying the
  3176. [AliasWindow] section in TOP.INI. See the chapter "Customization and TOP.INI"
  3177. for more details.
  3178.  
  3179. Using the Mouse and TOP Windows                                              5-6
  3180.  
  3181.  
  3182. TNC Technology                                                        TOP Manual
  3183.  
  3184. FILES Window
  3185.  
  3186. Selecting FILES from the chord menu brings up the FILES window containing an
  3187. alphabetical list of files, file information, directories, and file extensions
  3188. for the current directory. While this window is active, a left click on any
  3189. file in the window selects that item. A left drag copies the selected filename
  3190. (and its full path specification) to the command line at the command cursor or
  3191. to any other TOP window. In addition, a left double click on any file will
  3192. select the file, copy the filename to the command line at the command cursor,
  3193. and execute the resulting command line in one action.
  3194.  
  3195. Pull-down menus are available in the FILES window to change drives or change
  3196. file sort order. The pull-downs are actuated with a left press; release the
  3197. button on the desired selection.
  3198.  
  3199. To change directory or display filter, left click on the desired directory or
  3200. filter in the Dirs or Types area of the FILES window.
  3201.  
  3202. The FILES window can be moved and sized (see "TOP Window Functions - General
  3203. Usage"). Left clicking the close box will cancel the FILES window.
  3204.  
  3205. The FILES window initial position, initial size, initial state (on or off),
  3206. autoclose function, and use of colors is controlled by modifying the
  3207. [FilesWindow] section in TOP.INI. See the chapter "Customization and TOP.INI"
  3208. for more details.
  3209.  
  3210. HISTORY Window
  3211.  
  3212. Selecting HISTORY from the chord menu brings up the HISTORY window containing a
  3213. list of all the items currently in the command history buffer. While this
  3214. window is active, a left click on any item in the window selects that item. A
  3215. left drag copies the selected item to the command line at the command cursor or
  3216. to any other TOP window. In addition, a left double click on any item will
  3217. select the item, copy it to the command line at the command cursor, and execute
  3218. the resulting command line in one action.
  3219.  
  3220. The HISTORY window can be moved and sized (see "TOP Window Functions - General
  3221. Usage"). Left clicking the close box will cancel the HISTORY window.
  3222.  
  3223. The HISTORY window's initial position, initial size, initial state (on or off),
  3224. autoclose ability, and use of colors is controlled by modifying the
  3225. [HistoryWindow] section in TOP.INI. See the chapter "Customization and TOP.INI"
  3226. for more details.
  3227.  
  3228. LIST Window
  3229.  
  3230. Selecting LIST from the chord menu brings up the LIST window containing a
  3231. directory and files listing of the current directory. While this window is
  3232. active, a left click on any item in the window selects that item. A left drag
  3233. copies the selected item to the command line at the command cursor or to any
  3234. other TOP window. In addition, a left double click on any item will select the
  3235. item, copy it to the command line at the command cursor, and execute the
  3236. resulting command line in one action. If the item you left double clicked on
  3237. was a directory, the current directory is changed to that one and a new list is
  3238.  
  3239. Using the Mouse and TOP Windows                                              5-7
  3240.  
  3241.  
  3242. TNC Technology                                                        TOP Manual
  3243.  
  3244. displayed. Also, if a directory path specification is dragged into the LIST
  3245. window, the current directory is changed to the dragged specification.
  3246.  
  3247. The LIST window can be moved and sized (see "TOP Window Functions - General
  3248. Usage"). Left clicking the close box will cancel the LIST window.
  3249.  
  3250. The LIST window's initial position, initial size, initial state (on or off),
  3251. autoclose ability, and use of colors is controlled by modifying the
  3252. [ListWindow] section in TOP.INI. See the chapter "Customization and TOP.INI"
  3253. for more details.
  3254.  
  3255. VIEW Window
  3256.  
  3257. Selecting VIEW from the chord menu invokes the VIEW window, which displays the
  3258. contents of a file. The filename to be VIEWed is dragged into the window from
  3259. the FILES or LIST window with the LEFT mouse button.
  3260.  
  3261. Alternatively, VIEW can be started by typing:
  3262.  
  3263. view [filename]
  3264.  
  3265. at the command prompt. VIEW can also be started as a result of a pipe operation,
  3266.  as in:
  3267.  
  3268. dir | view
  3269.  
  3270. which would cause the output from the dir command in the VIEW window. As in any
  3271. window, right clicks or drags can highlight any text for subsequent pasting to
  3272. the command line at the command cursor or to any other TOP window.
  3273.  
  3274. The VIEW window can be moved and sized (see "TOP Window Functions - General
  3275. Usage"). Left clicking the close box will cancel the VIEW window.
  3276.  
  3277. The VIEW window's initial position, initial size, initial state (on or off),
  3278. autoclose ability, and use of colors is controlled by modifying the
  3279. [ViewWindow] section in TOP.INI. See the chapter "Customization and TOP.INI"
  3280. for more details.
  3281.  
  3282. HELP Window
  3283.  
  3284. Selecting HELP from the chord menu invokes the HELP window (identical to
  3285. pressing <F1>). After the HELP window is activated, repeated left clicks will
  3286. change HELP context to the text at the mouse position (especially useful on
  3287. "See Also" text, but works on any word displayed). HELP window topics can also
  3288. be seen or changed by dragging the topic into the HELP window from another
  3289. window or the screen using the Left mouse button.
  3290.  
  3291. The HELP window can be moved and sized (see "TOP Window Functions - General
  3292. Usage"). However, when a new topic is selected, the HELP window will
  3293. automatically resize itself to fit the topic. Left clicking the close box or
  3294. pressing <AltF1> will cancel the HELP window.
  3295.  
  3296. The HELP window's initial state (on or off), autoclose ability, and use of
  3297. colors is controlled by modifying the [HelpWindow] section in TOP.INI. See the
  3298.  
  3299. Using the Mouse and TOP Windows                                              5-8
  3300.  
  3301.  
  3302. TNC Technology                                                        TOP Manual
  3303.  
  3304. chapter "Customization and TOP.INI" for more details.
  3305.  
  3306.  
  3307.  
  3308.  
  3309.  
  3310.  
  3311.  
  3312.  
  3313.  
  3314.  
  3315.  
  3316.  
  3317.  
  3318.  
  3319.  
  3320.  
  3321.  
  3322.  
  3323.  
  3324.  
  3325.  
  3326.  
  3327.  
  3328.  
  3329.  
  3330.  
  3331.  
  3332.  
  3333.  
  3334.  
  3335.  
  3336.  
  3337.  
  3338.  
  3339.  
  3340.  
  3341.  
  3342.  
  3343.  
  3344.  
  3345.  
  3346.  
  3347.  
  3348.  
  3349.  
  3350.  
  3351.  
  3352.  
  3353.  
  3354.  
  3355.  
  3356.  
  3357.  
  3358.  
  3359. Using the Mouse and TOP Windows                                              5-9
  3360.  
  3361. ################################################################################
  3362. ################################################################################
  3363.  
  3364.  
  3365.  
  3366.  
  3367.  
  3368.  
  3369.  
  3370.  
  3371.  
  3372.  
  3373.  
  3374.  
  3375.  
  3376.  
  3377.  
  3378.  
  3379.  
  3380.  
  3381.  
  3382.  
  3383.  
  3384.  
  3385.  
  3386.  
  3387.  
  3388.  
  3389.  
  3390.                                   Chapter 6
  3391.                           Customization and TOP.INI
  3392.  
  3393.  
  3394. Note: This chapter was not inluded in the shareware release to conserve space.
  3395.       However, the entire contents of this chapter are available on line when
  3396.       using TOP's setup utility, TOPSET (included).
  3397.  
  3398.       The complete printed manual is included with your registration.
  3399.  
  3400.       
  3401.  
  3402.  
  3403.  
  3404.  
  3405.  
  3406.  
  3407.  
  3408.  
  3409.  
  3410.  
  3411.  
  3412.  
  3413.  
  3414.  
  3415.  
  3416.  
  3417.  
  3418. ################################################################################
  3419. ################################################################################
  3420.  
  3421. ################################################################################
  3422. ################################################################################
  3423.  
  3424.  
  3425.  
  3426.  
  3427.  
  3428.  
  3429.  
  3430.  
  3431.  
  3432.  
  3433.  
  3434.  
  3435.  
  3436.  
  3437.  
  3438.  
  3439.  
  3440.  
  3441.  
  3442.  
  3443.  
  3444.  
  3445.  
  3446.  
  3447.  
  3448.  
  3449.  
  3450.                                   Chapter 7
  3451.                             TOP Command Reference
  3452.  
  3453.  
  3454. Note: This chapter was not inluded in the shareware release to conserve space.
  3455.       However, the entire contents of this chapter are available on line when
  3456.       using TOP's HELP utility.
  3457.  
  3458.       The complete printed manual is included with your registration.
  3459.  
  3460.       
  3461.  
  3462.  
  3463.  
  3464.  
  3465.  
  3466.  
  3467.  
  3468.  
  3469.  
  3470.  
  3471.  
  3472.  
  3473.  
  3474.  
  3475.  
  3476.  
  3477.  
  3478. ################################################################################
  3479. ################################################################################
  3480.  
  3481. ################################################################################
  3482. ################################################################################
  3483.  
  3484.  
  3485.  
  3486.  
  3487.  
  3488.  
  3489.  
  3490.  
  3491.  
  3492.  
  3493.  
  3494.  
  3495.  
  3496.  
  3497.  
  3498.  
  3499.  
  3500.  
  3501.  
  3502.  
  3503.  
  3504.  
  3505.  
  3506.  
  3507.  
  3508.  
  3509.  
  3510.                                   Appendix A
  3511.                               Technical Support
  3512.  
  3513.  
  3514.  
  3515.  
  3516.  
  3517.  
  3518.  
  3519.  
  3520.  
  3521.  
  3522.  
  3523.  
  3524.  
  3525.  
  3526.  
  3527.  
  3528.  
  3529.  
  3530.  
  3531.  
  3532.  
  3533.  
  3534.  
  3535.  
  3536.  
  3537.  
  3538. ################################################################################
  3539. ################################################################################
  3540.  
  3541.  
  3542. TNC Technology                                                        TOP Manual
  3543.  
  3544. Technical Support Information
  3545.  
  3546. Technical support is available to all registered users in many forms. Please
  3547. feel free to use the service of your choice:
  3548.  
  3549. Problem resolutions are usually posted within 48 hours.
  3550.  
  3551. US Mail
  3552.  
  3553. TNC Technology
  3554. Attn: Technical Support
  3555. 1084 Webster Road
  3556. Webster, New York 14580
  3557.  
  3558. Voice
  3559.  
  3560. 716-872-1377 (after 6pm EST, M-F)
  3561. Machine attended during the day.
  3562.  
  3563. BBS
  3564.  
  3565. 716-872-4913 (8-N-1)
  3566. 24 hrs.
  3567.  
  3568. FAX
  3569.  
  3570. 716-872-1377
  3571. Press "7" after answer
  3572.  
  3573. CompuServe
  3574.  
  3575. 70403,2351
  3576. Checked Daily
  3577.  
  3578.  
  3579.  
  3580.  
  3581.  
  3582.  
  3583.  
  3584.  
  3585.  
  3586.  
  3587.  
  3588.  
  3589.  
  3590.  
  3591.  
  3592.  
  3593.  
  3594.  
  3595.  
  3596.  
  3597.  
  3598.  
  3599. Technical Support                                                            A-2
  3600.  
  3601. ################################################################################
  3602. ################################################################################
  3603.  
  3604.  
  3605.  
  3606.  
  3607.  
  3608.  
  3609.  
  3610.  
  3611.  
  3612.  
  3613.  
  3614.  
  3615.  
  3616.  
  3617.  
  3618.  
  3619.  
  3620.  
  3621.  
  3622.  
  3623.  
  3624.  
  3625.  
  3626.  
  3627.  
  3628.  
  3629.  
  3630.                                   Appendix B
  3631.                              Sample TOP.INI File
  3632.  
  3633.  
  3634. Note: This chapter was not inluded in the shareware release to conserve space.
  3635.       However, the entire contents of this chapter are available on line when
  3636.       using TOP's setup utility, TOPSET (included).
  3637.  
  3638.       The complete printed manual is included with your registration.
  3639.  
  3640.       
  3641.  
  3642.  
  3643.  
  3644.  
  3645.  
  3646.  
  3647.  
  3648.  
  3649.  
  3650.  
  3651.  
  3652.  
  3653.  
  3654.  
  3655.  
  3656.  
  3657.  
  3658. ################################################################################
  3659. ################################################################################
  3660.  
  3661. ################################################################################
  3662. ################################################################################
  3663.  
  3664.  
  3665.  
  3666.  
  3667.  
  3668.  
  3669.  
  3670.  
  3671.  
  3672.  
  3673.  
  3674.  
  3675.  
  3676.  
  3677.  
  3678.  
  3679.  
  3680.  
  3681.  
  3682.  
  3683.  
  3684.  
  3685.  
  3686.  
  3687.  
  3688.  
  3689.  
  3690.                                   Appendix C
  3691.                                   Using ANSI
  3692.  
  3693.  
  3694.  
  3695.  
  3696.  
  3697.  
  3698.  
  3699.  
  3700.  
  3701.  
  3702.  
  3703.  
  3704.  
  3705.  
  3706.  
  3707.  
  3708.  
  3709.  
  3710.  
  3711.  
  3712.  
  3713.  
  3714.  
  3715.  
  3716.  
  3717.  
  3718. ################################################################################
  3719. ################################################################################
  3720.  
  3721.  
  3722. TNC Technology                                                        TOP Manual
  3723.  
  3724. Using ANSI
  3725.  
  3726. This appendix explains ANSI escape sequences and how to use them. Also
  3727. explained is how to install ANSI.SYS, which enables DOS to use ANSI escape
  3728. sequences (more explanation below). However, ANSI.SYS is NOT required to be
  3729. installed for TOP. TOP completely emulates ANSI escape sequences in it's prompt
  3730. statement WITHOUT having ANSI.SYS loaded! If the only reason you have ANSI.SYS
  3731. loaded is to produce better prompts, you can remove it and save memory.
  3732.  
  3733. ANSI.SYS is an installable device driver that was included with your DOS
  3734. release. When installed, ANSI lets you use special escape sequences which give
  3735. you more control over video graphics mode and cursor movement. Normally ANSI is
  3736. used to enhance your prompt.
  3737.  
  3738. An ANSI escape sequence is a series of characters developed by the American
  3739. National Standards Institute (ANSI); the series always begins with the escape
  3740. character (ascii code 1B hex ). These escape sequences are how you go about
  3741. using ANSI.
  3742.  
  3743. Installing ANSI.SYS
  3744.  
  3745. Remember, ANSI.SYS is NOT required for TOP's prompt. If you must install
  3746. ANSI.SYS for other reasons, include the following line in your config.sys:
  3747.  
  3748. device=[d:][path]ANSI.SYS [/X] [/K]
  3749.  
  3750. Where:
  3751.  
  3752. [d:][path] specifies the drive and directory that contains ANSI.SYS
  3753.  
  3754. /X (DOS 4.0+ only) allows expanded keys on 101-key keyboards to be remapped
  3755. independently.
  3756.  
  3757. /K (DOS 5.0+ only) ignores expanded keys on 101-key keyboards
  3758.  
  3759. You must boot the computer after modifying config.sys for the changes to take
  3760. effect.
  3761.  
  3762. Using ANSI
  3763.  
  3764. To use ANSI escape sequences, first you must have some way to generate an
  3765. escape and the subsequent series of characters which define the desired ANSI
  3766. function, then you must issue the sequence via DOS function calls which use
  3767. standard input or standard output.
  3768.  
  3769. A perfect example of such a DOS function call is the command PROMPT. As you may
  3770. recall, PROMPT issues a sequence of characters to standard output every time
  3771. the <ENTER> key is pressed. PROMPT also recognizes its own special character
  3772. sequences, called meta-strings, which enable PROMPT to issue funny characters
  3773. like escape. Starting to sound suspiciously like a way to issue an ANSI escape
  3774. sequence isn't it? The PROMPT meta-string for escape is $e, so to include an
  3775. ANSI escape sequence in your prompt, you would include the sequence:
  3776.  
  3777. ...$e[ANSI sequence]...
  3778.  
  3779. Using ANSI                                                                   C-2
  3780.  
  3781.  
  3782. TNC Technology                                                        TOP Manual
  3783.  
  3784. For example, the following PROMPT command saves the cursor position, moves to
  3785. the top of the screen, prints "Hi!", returns the cursor to its original
  3786. position, outputs the current directory, and outputs the > character (do not
  3787. put spaces in the sequence, they were included only to show the individual
  3788. commands):
  3789.  
  3790. See ANSI Escape Sequences below for a more detailed explanation of the ANSI
  3791. sequences themselves (and the chapters "Using TOP" and TOP Command Reference"
  3792. for more information on the PROMPT command).
  3793.  
  3794. ANSI Escape Sequences
  3795.  
  3796. Each ANSI escape sequences is in the following form:
  3797.  
  3798. ESC[ parameters COMMAND
  3799.  
  3800. Where:
  3801.  
  3802. ESC represents the escape character
  3803.  
  3804. parameters can be one or more of:
  3805.  
  3806. n, a numeric parameter specified with ASCII digits
  3807.  
  3808. s, a numeric parameter used to specify a subfunction, specified with ASCII
  3809. digits
  3810.  
  3811. r, a row or line number
  3812.  
  3813. c, a column number
  3814.  
  3815. COMMAND is an alphabetic string which specifies the ANSI command. It is case
  3816. specific
  3817.  
  3818. Multiple parameters are separated by semicolons
  3819.  
  3820. ANSI Commands
  3821.  
  3822. ESC[r;cH
  3823. ESC[r;cf
  3824.  
  3825. Changes cursor position to r, c. If parameters are omitted, sends cursor home.
  3826.  
  3827. ESC[nA
  3828.  
  3829. Move cursor up by n lines without changing column. Ignored if cursor already at
  3830. the top.
  3831.  
  3832. ESC[nB
  3833.  
  3834. Move cursor down by n lines without changing column. Ignored if cursor already
  3835. at the bottom.
  3836.  
  3837. ESC[nC
  3838.  
  3839. Using ANSI                                                                   C-3
  3840.  
  3841.  
  3842. TNC Technology                                                        TOP Manual
  3843.  
  3844. Move cursor forward by n lines without changing row. Ignored if cursor already
  3845. at the right most edge.
  3846.  
  3847. ESC[nD
  3848.  
  3849. Move cursor backward by n lines without changing row. Ignored if cursor already
  3850. at the left most edge.
  3851.  
  3852. ESC[s
  3853.  
  3854. Save the current cursor position. The current cursor position can later be
  3855. restored with ESC[r.
  3856.  
  3857. ESC[u
  3858.  
  3859. Restore cursor position to the position saved with ESC[s.
  3860.  
  3861. ESC[2J
  3862.  
  3863. Erase the entire display and move cursor to home position (top left).
  3864.  
  3865. ESC[K
  3866.  
  3867. Erase to the end of the current row or line, including the current cursor
  3868. position.
  3869.  
  3870. ESC[s;...;sm
  3871.  
  3872. Set graphics rendition to s...s. The following graphic functions are possible:
  3873.  
  3874. Text Attributes
  3875. ------------------------------------------------------
  3876. 0     | All Attributes    | 5     | Blink On
  3877.       | Off               |       |
  3878. ------------------------------------------------------
  3879. 1     | Bold On           | 7     | Reverse Video On
  3880. ------------------------------------------------------
  3881. 4     | Underscore On     | 8     | Invisible On
  3882. ------------------------------------------------------
  3883. Foreground Colors         | Background Colors
  3884. ------------------------------------------------------
  3885. 30    | Black             | 40    | Black
  3886. ------------------------------------------------------
  3887. 31    | Red               | 41    | Red
  3888. ------------------------------------------------------
  3889. 32    | Green             | 42    | Green
  3890. ------------------------------------------------------
  3891. 33    | Yellow            | 43    | Yellow
  3892. ------------------------------------------------------
  3893. 34    | Blue              | 44    | Blue
  3894. ------------------------------------------------------
  3895. 35    | Magenta           | 45    | Magenta
  3896. ------------------------------------------------------
  3897. 36    | Cyan              | 46    | Cyan
  3898.  
  3899. Using ANSI                                                                   C-4
  3900.  
  3901.  
  3902. TNC Technology                                                        TOP Manual
  3903.  
  3904. ------------------------------------------------------
  3905. 37    | White             | 47    | White
  3906.  
  3907. ESC[=sh
  3908.  
  3909. Set video mode to s. The following mode functions are possible:
  3910.  
  3911. 0     | 40 x 25 B&W       | 7     | Wrap at end of
  3912.       |                   |       | line
  3913. ------------------------------------------------------
  3914. 1     | 40 x 25 Color     | 14    | 640 x 200 Color
  3915. ------------------------------------------------------
  3916. 2     | 80 x 25 B&W       | 15    | 640 x 350 B&W
  3917. ------------------------------------------------------
  3918. 3     | 80 x 25 Color     | 16    | 640 x 350 Color
  3919. ------------------------------------------------------
  3920. 4     | 320 x 200 Color   | 17    | 640 x 480 Color
  3921. ------------------------------------------------------
  3922. 5     | 320 x 200 B&W     | 18    | 640 x 480 Color
  3923. ------------------------------------------------------
  3924. 6     | 640 x 200 B&W     | 19    | 320 x 200 Color
  3925.  
  3926. ESC[=sl
  3927.  
  3928. Reset mode to s. See table above, except 7 which disables wrap at end of line.
  3929.  
  3930. ESC[code;string;...;stringp
  3931.  
  3932. Redefine the keyboard key specified by code to sequence given by string.
  3933.  
  3934. string is either the ASCII code for a single character or a character contained
  3935. in quotation marks. For example, both "a" and 97 are equivalent.
  3936.  
  3937. code can be one or more of the values listed in the following table. Semicolons
  3938. shown must be entered in addition to the required semicolons in the command.
  3939. Values shown in parentheses may not be available on all keyboards.
  3940.  
  3941. Key                | Code
  3942.                    ------------------------------------
  3943.                    | Alone  | Shift- | Ctrl-  | Alt-
  3944. -------------------------------------------------------
  3945. F1                 | 0;59   | 0;84   | 0;94   | 0;104
  3946. -------------------------------------------------------
  3947. F2                 | 0;60   | 0;85   | 0;95   | 0;105
  3948. -------------------------------------------------------
  3949. F3                 | 0;61   | 0;86   | 0;96   | 0;106
  3950. -------------------------------------------------------
  3951. F4                 | 0;62   | 0;87   | 0;97   | 0;107
  3952. -------------------------------------------------------
  3953. F5                 | 0;63   | 0;88   | 0;98   | 0;108
  3954. -------------------------------------------------------
  3955. F6                 | 0;64   | 0;89   | 0;99   | 0;109
  3956. -------------------------------------------------------
  3957. F7                 | 0;65   | 0;90   | 0;100  | 0;110
  3958.  
  3959. Using ANSI                                                                   C-5
  3960.  
  3961.  
  3962. TNC Technology                                                        TOP Manual
  3963.  
  3964. -------------------------------------------------------
  3965. F8                 | 0;66   | 0;91   | 0;101  | 0;111
  3966. -------------------------------------------------------
  3967. F9                 | 0;67   | 0;92   | 0;102  | 0;112
  3968. -------------------------------------------------------
  3969. F10                | 0;68   | 0;93   | 0;103  | 0;113
  3970. -------------------------------------------------------
  3971. F11                | 0;133  | 0;135  | 0;137  | 0;139
  3972. -------------------------------------------------------
  3973. F12                | 0;134  | 0;136  | 0;138  | 0;140
  3974. -------------------------------------------------------
  3975. HOME               | 0;71   | 55     | 0;119  | -
  3976. -------------------------------------------------------
  3977. UP ARROW           | 0;72   | 56     | (0;    | -
  3978.                    |        |        | 141)   |
  3979. -------------------------------------------------------
  3980. PAGE UP            | 0;73   | 57     | 0;132  | -
  3981. -------------------------------------------------------
  3982. LEFT ARROW         | 0;75   | 52     | 0;115  | -
  3983. -------------------------------------------------------
  3984. RIGHT ARROW        | 0;77   | 54     | 0;116  | -
  3985. -------------------------------------------------------
  3986. END                | 0;79   | 49     | 0;117  | -
  3987. -------------------------------------------------------
  3988. DOWN ARROW         | 0;80   | 50     | (0;    | -
  3989.                    |        |        | 145)   |
  3990. -------------------------------------------------------
  3991. PAGE DOWN          | 0;81   | 51     | 0;118  | -
  3992. -------------------------------------------------------
  3993. INSERT             | 0;82   | 48     | (0;    | -
  3994.                    |        |        | 146)   |
  3995. -------------------------------------------------------
  3996. DELETE             | 0;83   | 46     | (0;    | -
  3997.                    |        |        | 147)   |
  3998. -------------------------------------------------------
  3999. HOME (gray)        | (224;  | (224;  | (224;  | (224;
  4000.                    | 71)    | 71)    | 119)   | 151)
  4001. -------------------------------------------------------
  4002. UP ARROW (gray)    | (224;  | (224;  | (224;  | (224;
  4003.                    | 72)    | 72)    | 141)   | 152)
  4004. -------------------------------------------------------
  4005. PAGE UP (gray)     | (224;  | (224;  | (224;  | (224;
  4006.                    | 73)    | 73)    | 132)   | 153)
  4007. -------------------------------------------------------
  4008. LEFT ARROW (gray)  | (224;  | (224;  | (224;  | (224;
  4009.                    | 75)    | 75)    | 115)   | 155)
  4010. -------------------------------------------------------
  4011. RIGHT ARROW (gray) | (224;  | (224;  | (224;  | (224;
  4012.                    | 77)    | 77)    | 116)   | 157)
  4013. -------------------------------------------------------
  4014. END (gray)         | (224;  | (224;  | (224;  | (224;
  4015.                    | 79)    | 79)    | 117)   | 159)
  4016. -------------------------------------------------------
  4017. DOWN ARROW (gray)  | (224;  | (224;  | (224;  | (224;
  4018.  
  4019. Using ANSI                                                                   C-6
  4020.  
  4021.  
  4022. TNC Technology                                                        TOP Manual
  4023.  
  4024.                    | 80)    | 80)    | 145)   | 154)
  4025. -------------------------------------------------------
  4026. PAGE DOWN (gray)   | (224;  | (224;  | (224;  | (224;
  4027.                    | 81)    | 81)    | 118)   | 161)
  4028. -------------------------------------------------------
  4029. INSERT (gray)      | (224;  | (224;  | (224;  | (224;
  4030.                    | 82)    | 82)    | 146)   | 162)
  4031. -------------------------------------------------------
  4032. DELETE (gray)      | (224;  | (224;  | (224;  | (224;
  4033.                    | 83)    | 83)    | 147)   | 163)
  4034. -------------------------------------------------------
  4035. PRINT SCREEN       | -      | -      | 0;114  | -
  4036. -------------------------------------------------------
  4037. PAUSE/BREAK        | -      | -      | 0;0    | -
  4038. -------------------------------------------------------
  4039. BACKSPACE          | 8      | 8      | 127    | (0)
  4040. -------------------------------------------------------
  4041. ENTER              | 13     | -      | 10     | (0;28)
  4042. -------------------------------------------------------
  4043. TAB                | 9      | 0;15   | (0;    | (0;
  4044.                    |        |        | 148)   | 165)
  4045. -------------------------------------------------------
  4046. NULL               | 0;3    | -      | -      | -
  4047. -------------------------------------------------------
  4048. A                  | 97     | 65     | 1      | 0;30
  4049. -------------------------------------------------------
  4050. B                  | 98     | 66     | 2      | 0;48
  4051. -------------------------------------------------------
  4052. C                  | 99     | 67     | 3      | 0;46
  4053. -------------------------------------------------------
  4054. D                  | 100    | 68     | 4      | 0;32
  4055. -------------------------------------------------------
  4056. E                  | 101    | 69     | 5      | 0;18
  4057. -------------------------------------------------------
  4058. F                  | 102    | 70     | 6      | 0;33
  4059. -------------------------------------------------------
  4060. G                  | 103    | 71     | 7      | 0;34
  4061. -------------------------------------------------------
  4062. H                  | 104    | 72     | 8      | 0;35
  4063. -------------------------------------------------------
  4064. I                  | 105    | 73     | 9      | 0;23
  4065. -------------------------------------------------------
  4066. J                  | 106    | 74     | 10     | 0;36
  4067. -------------------------------------------------------
  4068. K                  | 107    | 75     | 11     | 0;37
  4069. -------------------------------------------------------
  4070. L                  | 108    | 76     | 12     | 0;38
  4071. -------------------------------------------------------
  4072. M                  | 109    | 77     | 13     | 0;50
  4073. -------------------------------------------------------
  4074. N                  | 110    | 78     | 14     | 0;49
  4075. -------------------------------------------------------
  4076. O                  | 111    | 79     | 15     | 0;24
  4077. -------------------------------------------------------
  4078.  
  4079. Using ANSI                                                                   C-7
  4080.  
  4081.  
  4082. TNC Technology                                                        TOP Manual
  4083.  
  4084. P                  | 112    | 80     | 16     | 0;25
  4085. -------------------------------------------------------
  4086. Q                  | 113    | 81     | 17     | 0;16
  4087. -------------------------------------------------------
  4088. R                  | 114    | 82     | 18     | 0;19
  4089. -------------------------------------------------------
  4090. S                  | 115    | 83     | 19     | 0;31
  4091. -------------------------------------------------------
  4092. T                  | 116    | 84     | 20     | 0;20
  4093. -------------------------------------------------------
  4094. U                  | 117    | 85     | 21     | 0;22
  4095. -------------------------------------------------------
  4096. V                  | 118    | 86     | 22     | 0;47
  4097. -------------------------------------------------------
  4098. W                  | 119    | 87     | 23     | 0;17
  4099. -------------------------------------------------------
  4100. X                  | 120    | 88     | 24     | 0;45
  4101. -------------------------------------------------------
  4102. Y                  | 121    | 89     | 25     | 0;21
  4103. -------------------------------------------------------
  4104. Z                  | 122    | 90     | 26     | 0;44
  4105. -------------------------------------------------------
  4106. 1                  | 49     | 33     | -      | 0;120
  4107. -------------------------------------------------------
  4108. 2                  | 50     | 64     | 0      | 0;121
  4109. -------------------------------------------------------
  4110. 3                  | 51     | 35     | -      | 0;122
  4111. -------------------------------------------------------
  4112. 4                  | 52     | 36     | -      | 0;123
  4113. -------------------------------------------------------
  4114. 5                  | 53     | 37     | -      | 0;124
  4115. -------------------------------------------------------
  4116. 6                  | 54     | 94     | 30     | 0;125
  4117. -------------------------------------------------------
  4118. 7                  | 55     | 38     | -      | 0;126
  4119. -------------------------------------------------------
  4120. 8                  | 56     | 42     | -      | 0;127
  4121. -------------------------------------------------------
  4122. 9                  | 57     | 40     | -      | 0;128
  4123. -------------------------------------------------------
  4124. 0                  | 48     | 41     | -      | 0;129
  4125. -------------------------------------------------------
  4126. -                  | 45     | 95     | 31     | 0;130
  4127. -------------------------------------------------------
  4128. =                  | 61     | 43     | -      | 0;131
  4129. -------------------------------------------------------
  4130. [                  | 91     | 123    | 27     | 0;26
  4131. -------------------------------------------------------
  4132. ]                  | 93     | 125    | 29     | 0;27
  4133. -------------------------------------------------------
  4134. \                  | 92     | 124    | 28     | 0;43
  4135. -------------------------------------------------------
  4136. ;                  | 59     | 58     | -      | 0;39
  4137. -------------------------------------------------------
  4138.  
  4139. Using ANSI                                                                   C-8
  4140.  
  4141.  
  4142. TNC Technology                                                        TOP Manual
  4143.  
  4144. '                  | 39     | 24     | -      | 0;40
  4145. -------------------------------------------------------
  4146.  ,                 | 44     | 60     | -      | 0;51
  4147. -------------------------------------------------------
  4148. .                  | 46     | 62     | -      | 0;52
  4149. -------------------------------------------------------
  4150. /                  | 47     | 63     | -      | 0;53
  4151. -------------------------------------------------------
  4152. `                  | 96     | 126    | -      | (0;41)
  4153. -------------------------------------------------------
  4154. ENTER (keypad)     | 13     | -      | 10     | (0;
  4155.                    |        |        |        | 166)
  4156. -------------------------------------------------------
  4157. / (keypad)         | 47     | 47     | (0;    | (0;74)
  4158.                    |        |        | 142)   |
  4159. -------------------------------------------------------
  4160. * (keypad)         | 42     | (0;    | (0;78) | -
  4161.                    |        | 144)   |        |
  4162. -------------------------------------------------------
  4163. - (keypad)         | 45     | 45     | (0;    | (0;
  4164.                    |        |        | 149)   | 164)
  4165. -------------------------------------------------------
  4166. + (keypad)         | 43     | 43     | (0;    | (0;55)
  4167.                    |        |        | 150)   |
  4168. -------------------------------------------------------
  4169. 5 (keypad)         | (0;76) | 53     | (0;    | -
  4170.                    |        |        | 143)   |
  4171.  
  4172. For example, to exchange the number 1 with the number 9 (and thoroughly confuse
  4173. anyone who uses your system), use the escape sequence:
  4174.  
  4175. ESC[49;57pESC[57;49p
  4176.  
  4177.  
  4178.  
  4179.  
  4180.  
  4181.  
  4182.  
  4183.  
  4184.  
  4185.  
  4186.  
  4187.  
  4188.  
  4189.  
  4190.  
  4191.  
  4192.  
  4193.  
  4194.  
  4195.  
  4196.  
  4197.  
  4198.  
  4199. Using ANSI                                                                   C-9
  4200.  
  4201. ################################################################################
  4202. ################################################################################
  4203.  
  4204.  
  4205.  
  4206.  
  4207.  
  4208.  
  4209.  
  4210.  
  4211.  
  4212.  
  4213.  
  4214.  
  4215.  
  4216.  
  4217.  
  4218.  
  4219.  
  4220.  
  4221.  
  4222.  
  4223.  
  4224.  
  4225.  
  4226.  
  4227.  
  4228.  
  4229.  
  4230.                                   Appendix D
  4231.                                    TOP DMTs
  4232.  
  4233.  
  4234.  
  4235.  
  4236.  
  4237.  
  4238.  
  4239.  
  4240.  
  4241.  
  4242.  
  4243.  
  4244.  
  4245.  
  4246.  
  4247.  
  4248.  
  4249.  
  4250.  
  4251.  
  4252.  
  4253.  
  4254.  
  4255.  
  4256.  
  4257.  
  4258. ################################################################################
  4259. ################################################################################
  4260.  
  4261.  
  4262. TNC Technology                                                        TOP Manual
  4263.  
  4264. Using TOP DMTs
  4265.  
  4266. DMT is an old three letter acronym (TLA) which stands for Day-Month-Time. In
  4267. the early days of non-personal computing, computers took too long to boot up,
  4268. so people never shut them off at all. In between times they still didn't want
  4269. the screen to show their private data though, so the concept of the DMT was
  4270. born. They reasoned: since I don't want anything on my screen, but I have all
  4271. this horsepower sitting idle, why not do something useful? A simple program was
  4272. written to continuously display the current day-month-time so the user could
  4273. have a warm fuzzy feeling that his computer had not yet crashed. Realizing that
  4274. a continuous display might burn the phosphor on their VDTs, the designers
  4275. decided to periodically move the day-month time display around. And thus, DMTs
  4276. were born.
  4277.  
  4278. Today, we can shut off our PCs, but we still tend to leave them on and
  4279. unattended during the day. And most of us still don't want our VDTs to have
  4280. burned phosphor. We could use a screen saver type program, but they just blank
  4281. the screen and don't do anything else to let us know whether or not our
  4282. computers have crashed. Besides, what if we didn't want to blank the screen,
  4283. but instead wanted to execute something else during an idle period? If TOP man
  4284. were here you know what he'd say: Use TOP!
  4285.  
  4286. TOPDMT: Automatic Time-out Execution
  4287.  
  4288. TOP has a function, called TOPDMT, which will automatically execute a program
  4289. after a user-definable period of idle time. The program can be any executable
  4290. but is typically a DMT. A few colorful screen saver sample programs have been
  4291. included with the shareware version of TOP (more are included with the
  4292. registered version).
  4293.  
  4294. TOPDMT is an environment variable used to specify the name of the program to be
  4295. executed when the KeyboardTimeout time specified in the [Initialize] section of
  4296. TOP.INI is satisfied. TOPDMT must contain a valid executable program, including
  4297. path definition if required. TOPDMT is usually specified in the
  4298. [InitialCommands] section of TOP.INI, but can be specified at the command line
  4299. using the SET command. Any user program can be specified by TOPDMT and it will
  4300. automatically be started after the idle time specified elapses (idle time is
  4301. when your computer is doing nothing else - i.e. when no programs are running
  4302. and the prompt is displayed). See also KeyboardTimeout in the [Initialize]
  4303. section of TOP.INI for more details.
  4304.  
  4305. Running TOPDMT Included Programs
  4306.  
  4307. After you have installed TOP, the TOPDMT programs will be located in a
  4308. subdirectory in the TOP directory called VIDEO. You can run any of these
  4309. programs by simply typing their name at the command line. It's usually best to
  4310. run the program this way first so you can decide how you want it configured. To
  4311. find out more about the options of a specific program, type the program name
  4312. followed by a question mark. A usage message will be displayed. Try running
  4313. them all!
  4314.  
  4315. Running Non-DMT Programs
  4316.  
  4317. To automatically run a non-DMT program, set TOPDMT to specify the name and path
  4318.  
  4319. TOP DMTs                                                                     D-2
  4320.  
  4321.  
  4322. TNC Technology                                                        TOP Manual
  4323.  
  4324. of that program. Include any required command line options. Also, unless the
  4325. program was written to be DMT aware (see Writing Your Own DMT below), you may
  4326. wish to set IgnoreDmtError to yes in the [Initialize] section of TOP.INI. This
  4327. will prevent TOP from falsely detecting exit error level codes from programs
  4328. that do not set the error level on exit.
  4329.  
  4330. Writing Your Own DMT
  4331.  
  4332. Writing your own DMT program might be easier than you expect, since TOP can do
  4333. some of the work for you. For example, the screen and mode does not need to be
  4334. saved if RestoreScreen and RestoreMode are yes in the [Video] section of
  4335. TOP.INI (these are the default settings).However, to be fully compatible with
  4336. TOP, you must accept a "-x exitTime" switch, and set the error level code
  4337. appropriately on exit. If you do not wish to comply with these compatibility
  4338. requirements, or you didn't write the DMT program, set IgnoreDmtError to yes in
  4339. the [Initialize] section of TOP.INI.
  4340.  
  4341. "-x exitTime" Switch
  4342.  
  4343. When TOP issues a DMT program command (as specified by the environment variable
  4344. TOPDMT), TOP automatically appends
  4345.  
  4346. -x exitTime
  4347.  
  4348. to the end of the issued command. "exitTime" is replaced by the number of
  4349. minutes to the next CRON job. It is expected the DMT program will exit after
  4350. exitTime minutes so the CRON job can be executed. When writing your own DMT
  4351. program, your program should also accept this parameter if you want CRON jobs
  4352. to be executed during DMT execution. When your program exits as a result of a
  4353. exitTime time-out, set the error level exit code to 2. This alerts TOP that the
  4354. exit was a planned result of exitTime. After the CRON job is executed, the DMT
  4355. will be restarted immediately, without waiting for a keyboard time-out.
  4356.  
  4357. Other Exit Codes
  4358.  
  4359. Your DMT program needs two other ways to exit: normally, or as a result of an
  4360. error. Normal exit is a result of the user wishing to terminate the DMT, i.e.
  4361. by pressing a key, etc. If the DMT program exits normally, set the error level
  4362. to 0. If your DMT program exits as a result of a detected error, such as not
  4363. enough memory, or a bad parameter on the command line, set the error level to
  4364. 1. This alerts TOP that an error occurred, and TOP will not try to reload the
  4365. DMT program until TOPDMT is changed.
  4366.  
  4367. Have fun and keep hacking!
  4368.  
  4369. Using PLAYTUNE
  4370.  
  4371. PLAYTUNE is a utility which reads and plays music. After you have installed TOP,
  4372.  PLAYTUNE will be located in a subdirectory in the TOP directory called AUDIO,
  4373. along with some sample music files. To run PLAYTUNE, type:
  4374.  
  4375. PLAYTUNE notefile [-t notetime]
  4376.  
  4377. where notefile is an ascii text file containing a sequence of musical notes,
  4378.  
  4379. TOP DMTs                                                                     D-3
  4380.  
  4381.  
  4382. TNC Technology                                                        TOP Manual
  4383.  
  4384. and optionally notetime is the time for one full note in milliseconds (the
  4385. default time if not specified is 250).
  4386.  
  4387. The format for each note in notefile is:
  4388.  
  4389. P [A] O  D [.]
  4390. |  |  |  |  +- Dot        if present, extends duration by 50%
  4391. |  |  |  +---- Duration   1 = whole note, 2 = half note...
  4392. |  |  +------- Octive     0 = lowest, 8 = highest
  4393. |  +---------- Accidental one of #,b [optional]
  4394. +------------- Pitch      one of A,B,C,D,E,F,G,R,-
  4395.                           (R or '-' means rest)
  4396.  
  4397. For example,
  4398.  
  4399. C#4 8
  4400.  
  4401. plays a sharp middle C for one eighth note.
  4402.  
  4403. Spaces, tabs, and carriage returns can optionally be placed between any note or
  4404. note element.
  4405.  
  4406. A few short tunes have been included with your TOP release. You'll find them in
  4407. the AUDIO subdirectory of your TOP directory. Have fun!
  4408.  
  4409.  
  4410.  
  4411.  
  4412.  
  4413.  
  4414.  
  4415.  
  4416.  
  4417.  
  4418.  
  4419.  
  4420.  
  4421.  
  4422.  
  4423.  
  4424.  
  4425.  
  4426.  
  4427.  
  4428.  
  4429.  
  4430.  
  4431.  
  4432.  
  4433.  
  4434.  
  4435.  
  4436.  
  4437.  
  4438.  
  4439. TOP DMTs                                                                     D-4
  4440.  
  4441. ################################################################################
  4442. ################################################################################
  4443.  
  4444.  
  4445.  
  4446.  
  4447.  
  4448.  
  4449.  
  4450.  
  4451.  
  4452.  
  4453.  
  4454.  
  4455.  
  4456.  
  4457.  
  4458.  
  4459.  
  4460.  
  4461.  
  4462.  
  4463.  
  4464.  
  4465.  
  4466.  
  4467.  
  4468.  
  4469.  
  4470.                                   Appendix E
  4471.                                  Using TOPSET
  4472.  
  4473.  
  4474.  
  4475.  
  4476.  
  4477.  
  4478.  
  4479.  
  4480.  
  4481.  
  4482.  
  4483.  
  4484.  
  4485.  
  4486.  
  4487.  
  4488.  
  4489.  
  4490.  
  4491.  
  4492.  
  4493.  
  4494.  
  4495.  
  4496.  
  4497.  
  4498. ################################################################################
  4499. ################################################################################
  4500.  
  4501.  
  4502. TNC Technology                                                        TOP Manual
  4503.  
  4504. Using TOP's Setup Utility: TOPSET
  4505.  
  4506. Included with your TOP release is TOPSET, an interactive setup tool to help you
  4507. easily set and maintain TOP parameters. Using TOPSET, all TOP parameters are
  4508. presented in a menu format, with context sensitive help for each entry.
  4509.  
  4510. Using TOPSET is exceptionally easy. At the command line, type TOPSET (with the
  4511. appropriate path specification if you are not in the TOP directory):
  4512.  
  4513. c:\top>topset<ENTER>
  4514.  
  4515. In fact, the default installation of TOP will define an FKEY to start TOPSET.
  4516. Just hit <Alt-T>. After starting, pressing <F1> displays help.
  4517.  
  4518. After starting, you'll see a menu of setup choices. Any of these can be
  4519. selected by using the arrow keys or the space bar and pressing <ENTER>. Also,
  4520. like all TOP tools, the mouse can be used. Just double click the left mouse
  4521. button on your choice.
  4522.  
  4523. After making a selection, you'll see a list of TOP parameters which can be
  4524. changed in a window on the left side of your screen. To select the parameter to
  4525. be changed, use the up or down arrow key to move the highlight over the
  4526. parameter you want to examine or change (or click the left mouse button on your
  4527. choice). If all the parameters don't fit in the window, scroll bars appear
  4528. which can be actuated with the up or down arrow keys or the left button of the
  4529. mouse.
  4530.  
  4531. As you move the highlight up and down you'll see complete help for that
  4532. parameter displayed in the window on the right side of the screen. The help
  4533. explains the setting of that parameter nd lists all choices.
  4534.  
  4535. If all the help doesn't fit in the window, scroll bars appear. The scroll bars
  4536. can be actuated with the <Page Up> or <Page Down> keys to scroll a page at a
  4537. time, or, on some keyboards, by pressing <Ctrl> with an up or down arrow. The
  4538. scroll bars can also be actuated with the left mouse button.
  4539.  
  4540. At any menu level in TOPSET, pressing <ESC> will move up one level. Pressing
  4541. the right mouse button is the same as pressing <ESC>.
  4542.  
  4543.  
  4544.  
  4545.  
  4546.  
  4547.  
  4548.  
  4549.  
  4550.  
  4551.  
  4552.  
  4553.  
  4554.  
  4555.  
  4556.  
  4557.  
  4558.  
  4559. Using TOPSET                                                                 E-2
  4560.  
  4561. ################################################################################
  4562. ################################################################################
  4563.  
  4564.  
  4565.  
  4566.  
  4567.  
  4568.  
  4569.  
  4570.  
  4571.  
  4572.  
  4573.  
  4574.  
  4575.  
  4576.  
  4577.  
  4578.  
  4579.  
  4580.  
  4581.  
  4582.  
  4583.  
  4584.  
  4585.  
  4586.  
  4587.  
  4588.  
  4589.  
  4590.                                   Appendix F
  4591.                                TOP Color Names
  4592.  
  4593.  
  4594.  
  4595.  
  4596.  
  4597.  
  4598.  
  4599.  
  4600.  
  4601.  
  4602.  
  4603.  
  4604.  
  4605.  
  4606.  
  4607.  
  4608.  
  4609.  
  4610.  
  4611.  
  4612.  
  4613.  
  4614.  
  4615.  
  4616.  
  4617.  
  4618. ################################################################################
  4619. ################################################################################
  4620.  
  4621.  
  4622. TNC Technology                                                        TOP Manual
  4623.  
  4624. TOP Color Names
  4625.  
  4626. Included below is a complete list of color names which can be used in either
  4627. the [Palette] or [AnalogMonoPalette] sections of TOP.INI. This list is also
  4628. available on line when using TOPSET, TOP's setup utility.
  4629.  
  4630.                      |  Equivalent color setting
  4631.      Color Name      ---------------------------------
  4632.                      | Red      | Green    | Blue
  4633. ------------------------------------------------------
  4634. Black                | 0        | 0        | 0
  4635. ------------------------------------------------------
  4636. Blue                 | 0        | 0        | 168
  4637. ------------------------------------------------------
  4638. MediumBlue           | 0        | 0        | 205
  4639. ------------------------------------------------------
  4640. BrightBlue           | 84       | 84       | 255
  4641. ------------------------------------------------------
  4642. DarkGreen            | 0        | 100      | 0
  4643. ------------------------------------------------------
  4644. Green                | 0        | 168      | 0
  4645. ------------------------------------------------------
  4646. Cyan                 | 0        | 168      | 168
  4647. ------------------------------------------------------
  4648. DeepSkyBlue          | 0        | 191      | 255
  4649. ------------------------------------------------------
  4650. DarkTurquoise        | 0        | 206      | 209
  4651. ------------------------------------------------------
  4652. MediumSpringGreen    | 0        | 250      | 154
  4653. ------------------------------------------------------
  4654. BrightGreen          | 84       | 255      | 84
  4655. ------------------------------------------------------
  4656. SpringGreen          | 0        | 255      | 127
  4657. ------------------------------------------------------
  4658. BrightCyan           | 84       | 255      | 255
  4659. ------------------------------------------------------
  4660. MidnightBlue         | 25       | 25       | 112
  4661. ------------------------------------------------------
  4662. DodgerBlue           | 30       | 144      | 255
  4663. ------------------------------------------------------
  4664. LightSeaGreen        | 32       | 178      | 170
  4665. ------------------------------------------------------
  4666. ForestGreen          | 34       | 139      | 34
  4667. ------------------------------------------------------
  4668. SeaGreen             | 46       | 139      | 87
  4669. ------------------------------------------------------
  4670. DarkSlateGray        | 47       | 79       | 79
  4671. ------------------------------------------------------
  4672. LimeGreen            | 50       | 205      | 50
  4673. ------------------------------------------------------
  4674. MediumSeaGreen       | 60       | 179      | 113
  4675. ------------------------------------------------------
  4676. DarkGray             | 84       | 84       | 84
  4677. ------------------------------------------------------
  4678.  
  4679. TOP Color Names                                                              F-2
  4680.  
  4681.  
  4682. TNC Technology                                                        TOP Manual
  4683.  
  4684. Turquoise            | 64       | 224      | 208
  4685. ------------------------------------------------------
  4686. RoyalBlue            | 65       | 105      | 225
  4687. ------------------------------------------------------
  4688. SteelBlue            | 70       | 130      | 180
  4689. ------------------------------------------------------
  4690. DarkSlateBlue        | 72       | 61       | 139
  4691. ------------------------------------------------------
  4692. MediumTurquoise      | 72       | 209      | 204
  4693. ------------------------------------------------------
  4694. DarkOliveGreen       | 85       | 107      | 47
  4695. ------------------------------------------------------
  4696. CadetBlue            | 95       | 158      | 160
  4697. ------------------------------------------------------
  4698. CornflowerBlue       | 100      | 149      | 237
  4699. ------------------------------------------------------
  4700. MediumAquamarine     | 102      | 205      | 170
  4701. ------------------------------------------------------
  4702. Gray                 | 105      | 105      | 105
  4703. ------------------------------------------------------
  4704. SlateBlue            | 106      | 90       | 205
  4705. ------------------------------------------------------
  4706. OliveDrab            | 107      | 142      | 35
  4707. ------------------------------------------------------
  4708. SlateGray            | 112      | 128      | 144
  4709. ------------------------------------------------------
  4710. LightSlateGray       | 119      | 136      | 153
  4711. ------------------------------------------------------
  4712. MediumSlateBlue      | 123      | 104      | 238
  4713. ------------------------------------------------------
  4714. LawnGreen            | 124      | 252      | 0
  4715. ------------------------------------------------------
  4716. Aquamarine           | 127      | 255      | 212
  4717. ------------------------------------------------------
  4718. Red                  | 168      | 0        | 0
  4719. ------------------------------------------------------
  4720. Magenta              | 168      | 0        | 168
  4721. ------------------------------------------------------
  4722. DimOrange            | 128      | 64       | 0
  4723. ------------------------------------------------------
  4724. DimYellow            | 168      | 168      | 0
  4725. ------------------------------------------------------
  4726. White                | 168      | 168      | 168
  4727. ------------------------------------------------------
  4728. LightSlateBlue       | 132      | 112      | 255
  4729. ------------------------------------------------------
  4730. SkyBlue              | 135      | 206      | 235
  4731. ------------------------------------------------------
  4732. LightSkyBlue         | 135      | 206      | 250
  4733. ------------------------------------------------------
  4734. BlueViolet           | 138      | 43       | 226
  4735. ------------------------------------------------------
  4736. SaddleBrown          | 139      | 69       | 19
  4737. ------------------------------------------------------
  4738.  
  4739. TOP Color Names                                                              F-3
  4740.  
  4741.  
  4742. TNC Technology                                                        TOP Manual
  4743.  
  4744. DarkSeaGreen         | 143      | 188      | 143
  4745. ------------------------------------------------------
  4746. MediumPurple         | 147      | 112      | 219
  4747. ------------------------------------------------------
  4748. DarkViolet           | 148      | 0        | 211
  4749. ------------------------------------------------------
  4750. PaleGreen            | 152      | 251      | 152
  4751. ------------------------------------------------------
  4752. DarkOrchid           | 153      | 50       | 204
  4753. ------------------------------------------------------
  4754. YellowGreen          | 154      | 205      | 50
  4755. ------------------------------------------------------
  4756. Purple               | 160      | 32       | 240
  4757. ------------------------------------------------------
  4758. Sienna               | 160      | 82       | 45
  4759. ------------------------------------------------------
  4760. Brown                | 165      | 42       | 42
  4761. ------------------------------------------------------
  4762. LightBlue            | 173      | 216      | 230
  4763. ------------------------------------------------------
  4764. GreenYellow          | 173      | 255      | 47
  4765. ------------------------------------------------------
  4766. PaleTurquoise        | 175      | 238      | 238
  4767. ------------------------------------------------------
  4768. Maroon               | 176      | 48       | 96
  4769. ------------------------------------------------------
  4770. LightSteelBlue       | 176      | 196      | 222
  4771. ------------------------------------------------------
  4772. PowderBlue           | 176      | 224      | 230
  4773. ------------------------------------------------------
  4774. Firebrick            | 178      | 34       | 34
  4775. ------------------------------------------------------
  4776. DarkGoldenrod        | 184      | 134      | 11
  4777. ------------------------------------------------------
  4778. MediumOrchid         | 186      | 85       | 211
  4779. ------------------------------------------------------
  4780. RosyBrown            | 188      | 143      | 143
  4781. ------------------------------------------------------
  4782. DarkKhaki            | 189      | 183      | 107
  4783. ------------------------------------------------------
  4784. PaleGray             | 192      | 192      | 192
  4785. ------------------------------------------------------
  4786. MediumVioletRed      | 199      | 21       | 133
  4787. ------------------------------------------------------
  4788. IndianRed            | 205      | 92       | 92
  4789. ------------------------------------------------------
  4790. Peru                 | 205      | 133      | 63
  4791. ------------------------------------------------------
  4792. VioletRed            | 208      | 32       | 144
  4793. ------------------------------------------------------
  4794. Chocolate            | 210      | 105      | 30
  4795. ------------------------------------------------------
  4796. Tan                  | 210      | 180      | 140
  4797. ------------------------------------------------------
  4798.  
  4799. TOP Color Names                                                              F-4
  4800.  
  4801.  
  4802. TNC Technology                                                        TOP Manual
  4803.  
  4804. LightGray            | 211      | 211      | 211
  4805. ------------------------------------------------------
  4806. Thistle              | 216      | 191      | 216
  4807. ------------------------------------------------------
  4808. Orchid               | 218      | 112      | 214
  4809. ------------------------------------------------------
  4810. Goldenrod            | 218      | 165      | 32
  4811. ------------------------------------------------------
  4812. PaleVioletRed        | 219      | 112      | 147
  4813. ------------------------------------------------------
  4814. Gainsboro            | 220      | 220      | 220
  4815. ------------------------------------------------------
  4816. Plum                 | 221      | 160      | 221
  4817. ------------------------------------------------------
  4818. Burlywood            | 222      | 184      | 135
  4819. ------------------------------------------------------
  4820. LightCyan            | 224      | 255      | 255
  4821. ------------------------------------------------------
  4822. Lavender             | 230      | 230      | 250
  4823. ------------------------------------------------------
  4824. DarkSalmon           | 233      | 150      | 122
  4825. ------------------------------------------------------
  4826. Violet               | 238      | 130      | 238
  4827. ------------------------------------------------------
  4828. LightGoldenrod       | 238      | 221      | 130
  4829. ------------------------------------------------------
  4830. PaleGoldenrod        | 238      | 232      | 170
  4831. ------------------------------------------------------
  4832. LightCoral           | 240      | 128      | 128
  4833. ------------------------------------------------------
  4834. Khaki                | 240      | 230      | 140
  4835. ------------------------------------------------------
  4836. AliceBlue            | 240      | 248      | 255
  4837. ------------------------------------------------------
  4838. Honeydew             | 240      | 255      | 240
  4839. ------------------------------------------------------
  4840. Azure                | 240      | 255      | 255
  4841. ------------------------------------------------------
  4842. SandyBrown           | 244      | 164      | 96
  4843. ------------------------------------------------------
  4844. Wheat                | 245      | 222      | 179
  4845. ------------------------------------------------------
  4846. Beige                | 245      | 245      | 220
  4847. ------------------------------------------------------
  4848. WhiteSmoke           | 245      | 245      | 245
  4849. ------------------------------------------------------
  4850. MintCream            | 245      | 255      | 250
  4851. ------------------------------------------------------
  4852. GhostWhite           | 248      | 248      | 255
  4853. ------------------------------------------------------
  4854. Salmon               | 250      | 128      | 114
  4855. ------------------------------------------------------
  4856. AntiqueWhite         | 250      | 235      | 215
  4857. ------------------------------------------------------
  4858.  
  4859. TOP Color Names                                                              F-5
  4860.  
  4861.  
  4862. TNC Technology                                                        TOP Manual
  4863.  
  4864. Linen                | 250      | 240      | 230
  4865. ------------------------------------------------------
  4866. YellowGoldenrod      | 250      | 250      | 210
  4867. ------------------------------------------------------
  4868. OldLace              | 253      | 245      | 230
  4869. ------------------------------------------------------
  4870. BrightRed            | 255      | 84       | 84
  4871. ------------------------------------------------------
  4872. BrightMagenta        | 255      | 84       | 255
  4873. ------------------------------------------------------
  4874. DeepPink             | 255      | 20       | 147
  4875. ------------------------------------------------------
  4876. OrangeRed            | 255      | 69       | 0
  4877. ------------------------------------------------------
  4878. Tomato               | 255      | 99       | 71
  4879. ------------------------------------------------------
  4880. HotPink              | 255      | 105      | 180
  4881. ------------------------------------------------------
  4882. Coral                | 255      | 127      | 80
  4883. ------------------------------------------------------
  4884. DeepOrange           | 255      | 140      | 0
  4885. ------------------------------------------------------
  4886. LightSalmon          | 255      | 160      | 122
  4887. ------------------------------------------------------
  4888. Orange               | 255      | 165      | 0
  4889. ------------------------------------------------------
  4890. LightPink            | 255      | 182      | 193
  4891. ------------------------------------------------------
  4892. Pink                 | 255      | 192      | 203
  4893. ------------------------------------------------------
  4894. Gold                 | 255      | 215      | 0
  4895. ------------------------------------------------------
  4896. PeachPuff            | 255      | 218      | 185
  4897. ------------------------------------------------------
  4898. NavajoWhite          | 255      | 222      | 173
  4899. ------------------------------------------------------
  4900. Moccasin             | 255      | 228      | 181
  4901. ------------------------------------------------------
  4902. Bisque               | 255      | 228      | 196
  4903. ------------------------------------------------------
  4904. MistyRose            | 255      | 228      | 225
  4905. ------------------------------------------------------
  4906. BlanchedAlmond       | 255      | 235      | 205
  4907. ------------------------------------------------------
  4908. PapayaWhip           | 255      | 239      | 213
  4909. ------------------------------------------------------
  4910. LavenderBlush        | 255      | 240      | 245
  4911. ------------------------------------------------------
  4912. Seashell             | 255      | 245      | 238
  4913. ------------------------------------------------------
  4914. Cornsilk             | 255      | 248      | 220
  4915. ------------------------------------------------------
  4916. LemonChiffon         | 255      | 250      | 205
  4917. ------------------------------------------------------
  4918.  
  4919. TOP Color Names                                                              F-6
  4920.  
  4921.  
  4922. TNC Technology                                                        TOP Manual
  4923.  
  4924. FloralWhite          | 255      | 250      | 240
  4925. ------------------------------------------------------
  4926. Snow                 | 255      | 250      | 250
  4927. ------------------------------------------------------
  4928. Yellow               | 255      | 255      | 84
  4929. ------------------------------------------------------
  4930. LightYellow          | 255      | 255      | 224
  4931. ------------------------------------------------------
  4932. Ivory                | 255      | 255      | 240
  4933. ------------------------------------------------------
  4934. BrightWhite          | 255      | 255      | 255
  4935.  
  4936.  
  4937.  
  4938.  
  4939.  
  4940.  
  4941.  
  4942.  
  4943.  
  4944.  
  4945.  
  4946.  
  4947.  
  4948.  
  4949.  
  4950.  
  4951.  
  4952.  
  4953.  
  4954.  
  4955.  
  4956.  
  4957.  
  4958.  
  4959.  
  4960.  
  4961.  
  4962.  
  4963.  
  4964.  
  4965.  
  4966.  
  4967.  
  4968.  
  4969.  
  4970.  
  4971.  
  4972.  
  4973.  
  4974.  
  4975.  
  4976.  
  4977.  
  4978.  
  4979. TOP Color Names                                                              F-7
  4980.  
  4981.